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Gratulation zum Erwerb des Optimierenden-Makro-Assemblers V3.0. Sie besitzen nun 
eines der leistungfähigsten Assemblerpakete für die Commodore-Amiga-Familie. Bevor 
Sie die gelieferten Programme benutzen, sollten Sie die Handbücher genau lesen, um 
Irrtümern und Ärgernissen vorzubeugen. 

Alle Programme arbeiten mit speichererweiterten Maschinen und in Verbindung mit 
allen Prozessoren der M68000-Familie. Ab Workbench 1.3 können Sie alle Programme 
resident halten, nur Editor und Debugger dürfen dann nicht gleichzeitig von mehreren 
Prozessen aus benutzt werden. Die übrigen Programme verkraften dies problemlos. Das 
Paket arbeitet auch ab dem Betriebssystem 2.0 korrekt. 

Ganz besonders möchte ich Herrn Dieter Reitzner danken, ohne dessen beraterische 
Tätigkeit und Verbesserungsvorschläge das Paket nicht in dieser Form verfügbar gewe¬ 
sen wäre. 

Alle Programme und Dateien sowie die Handbücher sind Co¬ 
pyright 1994 bei Dietmar Heidrich, Blenderstraße 60, D-28279 
Bremen. 

Jede Art der Reproduktion, Verbreitung oder Verteilung, ganz 
oder teilweise, der Handbücher oder Programme oder Dateien ist 
ausdrücklich laut Lizenzbedingungen verboten. Zuwiderhandlun¬ 
gen werden juristisch verfolgt. 

Sollten Sie Fehler in einem der Programme entdecken, stellen Sie bitte fest, ob und 
unter welchen Bedingungen der Fehler reproduzierbar ist. Versuchen Sie, dieses genau 
zu beschreiben und erwähnen Sie, mit welchen Komponenten Ihr Rechner ausgestattet 
ist. Melden Sie den Fehler an: 

ICP-Innovativ Computer Presse GmbH &: Co. KG 
Wendelsteinstraße 3, D-85591 Vaterstetten 

Falls Sie nun das Vertrauen in OMA verloren haben sollten, lassen Sie sich beruhigen: 
Das gesamte Assemblerpaket wurde mit sich selber erstellt, assembliert und gelinkt. 
Die Programme befinden sich nun schon seit einigen Jahren erfolgreich im Einsatz, und 
es wurden alle bekannten Fehler eliminiert. 

Dieses Handbuch wurde mit dem HiTex-Editor Version 3.0 erstellt und mit Hilfe von 
T^X gesetzt. 


Amiga, Amiga-DOS, Workbench, Intuition, GadTools und ASL sind Warenzeichen von 
Commodore-Amiga, Inc. 

Metacomco ist ein Warenzeichen von Metacomco plc. 

Devpac ist ein Warenzeichen von HiSoft. 
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Kapitel 1 


Einführung 


1.1 Installation 

Für die Installation setze ich voraus, daß Sie den Amiga mit dem CLI bedienen können 
und sich dort einigermaßen auskennen. Sollte dies nicht der Fall sein, dann lesen Sie 
bitte Ihr Bedienerhandbuch zum Amiga durch, speziell den Amiga-DOS-Teil. Vor allen 
anderen Aktionen sollten Sie eine Kopie von Ihrer Original-Assembler-Diskette machen. 
Arbeiten Sie nicht mit dem Original, sondern immer mit der Kopie. 

1. Schieben Sie die Assembler-Diskette in ein Laufwerk. 

2. Lesen Sie mit einem Editor die auf der Diskette enthaltene Datei LiesMich oder 
lassen Sie sie auf dem Terminal mittels 

Type "OMA V3.0:Lie$Mich" 

ausgeben. Da das Assemblerpaket ständig überarbeitet wird, enthält diese Datei 
aktuelle Informationen über z.B. Fehlerkorrekturen oder Erweiterungen, die nicht 
in den Handbüchern stehen. 

3. Erzeugen Sie auf Ihrer Systemdiskette (evtl, eine Festplatten-Partition) ein Di¬ 
rectory namens ACom durch den CLI-Befehl 

Makedir SYS:ACom 

4. Kopieren Sie den Inhalt der Assembler-Diskette in das gerade erzeugte Directory. 
Dazu können Sie die Batchdatei der Assembler-Diskette benutzen, da auf der 
Assembler-Diskette einige Directories und Dateien vorhanden sind, die Sie nicht 
auf Ihrer Systemdiskette benötigen: 

Execute "OMA V3.0:Kopiere.batch" SYS:ACom 

Achten Sie darauf, daß Sie genug Platz auf Ihrer Systemdiskette haben, denn 
sonst bekommen Sie eine Systemmeldung. Schaffen Sie in dem Fall genug Platz 
und wiederholen Sie den obigen Befehl. 

5. Nehmen Sie mit einem Editor folgende Zeilen in Ihre Startup-Sequenz im DEVS:- 
Directory auf (Reihenfolge nicht ändern): 
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Assign ACOM: SYS:ACom 
Assign AINC: ACOM:Include 
Assign ALIB: ACOM:Libraries 
Path ACOM: add 

Den letzten Befehl können Sie natürlich in einem evtl, bereits vorhandenen Path- 
Befehl unterbringen. 

6. Setzen Sie Ihren Rechner zurück und booten Sie neu. Nun können Sie das As¬ 
semblerpaket benutzen und die Programme starten. Falls Sie die Workbench 1.3 
besitzen und die Shell benutzen, sollten Sie dieser (evtl, in der Datei S:Shell- 
Startup) noch 

Alias ED Run ACOM:Editor [] 

befehlen, damit Sie unter der Shell nur noch ED aufrufen müssen, um den Editor 
als Ilintergrundbefehl ablaufen zu lassen. 

Bitte beachten Sie, daß bei Benutzung der Workbench mit dem Editor das Zuweisen 
des ACOM:-Directories notwendig wird, da der Editor Icons zu den Texten abspeichert, 
deren Default-Tool »ACOM:Editor< lautet. Daher sollten Sie den oben gezeigten Weg 
befolgen. 

1.2 Tutorium 

Dieses Kapitel ist als (sehr) kurze Einführung in die Bedienung des Assemblerpaketes 
gedacht. Sie werden sich dadurch nicht ersparen, die Handbücher komplett zu lesen, da 
die Programme viel zu komplex sind, als daß es möglich wäre, ihren Funktionsumfang 
auf ein paar Seiten zu beschreiben. 

Gehen Sie in das CLI oder in eine Shell und rufen Sie den Editor per run Editor bzw. 
run ACOM: Editor (siehe obige Installation) auf. Das Programm startet und wartet auf 
Ihre Befehle. In der Menüleiste finden Sie ganz rechts das Assembler-Menü. Wählen Sie 
in diesem Menü den Punkt Load Assembler. Es erscheint der File-Requester des Editors. 
Wählen Sie nun den Assembler zum Laden aus, indem Sie seinen Namen eingeben 
oder doppelt anklicken. Nun können Sie Assemblerprogramme direkt vom Editor aus 
übersetzen lassen. Der Aufruf dazu befindet sich ebenfalls im Assembler-Menü unter 
Assemble. Sie möchten nun ein Beispiel ausprobieren (doch, doch, das möchten Sie!). 
Geben Sie dem aktuellen Textpuffer erst einmal einen Namen, indem Sie Rename buffer 
aus dem Buffer-Menü auswählen, beim dann erscheinenden File-Requester den Namen 
beispiel .asm eintippen und <Return> drücken. Geben Sie jetzt folgenden Text ein: 
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Das Programm zählt einfach bis zu einer Million. Rufen Sie nun Assemble auf. Der 
Assemble-Requester erscheint mit einer Anzahl Gadgets und dem gleich aktivierten 
Objektfilenamen. Drücken Sie nicht <R.eturn>, da sonst der Assemblerlauf gestartet 
würde, sondern überprüfen Sic erst einmal die Gadgets: »Fast Mode<, »Statistics«, 
»Optimize«, »Object hle< nicht, »Case distinct«, »Warnings< und »Into memory« 
sollten gewählt sein. Wenn Sie dies einmal eingestellt, haben, brauchen Sie bei weiteren 
Assemblerläufen keine Änderung zu machen. Klicken Sie nun auf das »Ok<-Gadget 
und sehen Sie, was passiert. 

Der Editor schaltet auf die Workbench, öffnet ein Fenster, und der Assembler beginnt 
zu arbeiten. Wenn er fertig ist, bekommen Sie eine entsprechende Meldung. Drücken 
Sie nun wie verlangt die Return-Taste. Falls beim Assemblieren ein Fehler auftrat, wird 
jetzt die fehlerhafte Zeile angesteuert, und der Editor druckt die Fehlermeldung auf 
die unterste Zeile (die unter dem durchgezogenen Strich). Sic können nun das fertige 
Programm ausführen lassen, indem Sie den Menüpunkt Run wählen. Als Alternative 
können Sie das Make-Utility des Editors benutzen, welches Ihnen nicht nur erlaubt, 
große, linkbare Programme zu pflegen, sondern sie auch gleich zu starten. Dazu müssen 
Sie aber das Programm z.B. in die RAM-Disk assemblieren bzw. linken lassen und wie 
unter dem CLI starten. 

Da Sie sich gerade im Editor befinden, sollten Sie ihn jetzt einmal ausprobieren. Sie 
können nichts kaputt machen, solange Sie keine Texte über das Project-Menü speichern. 
Testen Sie, wie die Cursor-Tasten arbeiten, speziell in Zusammenhang mit <Shift>, 
<Alt> usw. Der Editor wird nämlich für Ihre Arbeit mit OMA die Plattform bilden 
und eignet sich im Gegensatz zu Assembler und Linker hervorragend zum Eingewöhnen 
durch Herumspielen. Falls Sie etwas nicht verstehen, können Sie das Stichwortverzeich¬ 
nis im Editor-Handbuch benutzen. 


moveq #0,d0 
1$ addq.l #l,d0 

cmp.l #1000000,dO 
blo.s 1$ 

#0,d0 ; Rueckgabe an das DOS 


moveq 

rts 

END 
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Kapitel 2 

HiTex-Editor V3.0 

2.1 Einführung 

Das wichtigste Werkzeug der Programmentwicklung ist ein leistungsfähiger, komforta¬ 
bler Editor. Dabei ist es egal, in welcher Sprache entwickelt wird, denn die meiste Zeit 
wird beim Editieren benötigt. Mit dem HiTex-Editor Version 3.0 haben Sie nun einen 
universellen Texteditor in der Hand, der flexibel genug ist, sich Ihren Bedürfnissen anzu¬ 
passen. Er wurde so konzipiert, daß Ihnen bei der anstrengenden Programmiertätigkeit 
möglichst keine Steine in den Weg gelegt werden, schließlich möchten Sie Programme 
schreiben und sich nicht über unzulängliche Werkzeuge ärgern. 

Der HiTex-Editor 3.0 stammt von den Editoren des Optimierenden Makro-Assemblers 
ab. Er ist mit dem User-Interface-Style-Cuide von Commodore konform und unterstützt 
beliebige Fonts. Er kann auf einem Public-Screen oder einem eigenen Screen laufen. Zu 
seinen Highlights gehören eine freie Konfigurierbarkeit von Tastaturkommandos und 
Menüs sowie eine umfangreiche Unterstützung von ARexx, der seit Kickstart 2.0 jedem 
Amiga beiliegenden Skript-Programmiersprache. Mit Hilfe von ARexx ist es möglich, 
auf der vom Editor gelieferten Funktionalität aufzubauen und Funktionen zu realisieren, 
die immens komplexe Operationen auf den Texten durchführen. 

Der HiTex-Editor verarbeitet und erzeugt Texte im ASCII-Format. Dabei ist folgendes 
zu beachten: 

• Eine Zeile darf bis zu 254 Zeichen lang sein. Sie endet immer mit einem Linefeed 
(Code $0A). 

• Bei eingelesenen Fremd-Dateien wird ein Zeilenende nur an einem Linefeed er¬ 
kannt. Carriage-Return (Code $0D) alleine reicht nicht aus. Überlange Zeilen 
spaltet der Editor in mehrere Zeilen auf und meldet diese Aktion. Die Kom¬ 
bination $0D-$0A bewirkt nur einen Zeilen Wechsel, das Carriage-Return bleibt 
allerdings sichtbar. 
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Ich empfehle Ihnen, dieses Handbuch am Rechner durchzuarbeiten und die Funktionen 
des Editors gleich auszuprobieren. Dies wird Ihnen helfen, die Arbeitsweise des Editors 
zu verstehen, und beugt Mißverständnissen vor. Im Handbuch wird bei Menü- und 
Tastenbelegungen von der Standardkonfiguration ausgegangen. Da der Editor jedoch 
frei konfigurierbar ist, können Sie die Befehle so auf Menüs und Tasten legen, wie Sie 
es Ihnen gefällt (siehe auch Kapitel 2.10 über die Editor-Konfiguration). 

Hier noch eine kleine Zusammenfassung der Leistungsmerkmale: 

• arbeitet auf allen Amiga-Modellen ab Kickstart 2.0, volle 2.0-, ECS-, AA-, AGA- 
und sonstige Unterstützung 

• ARexx-Unterstützung 

• frei konfigurierbar und foritskalierend 

• beliebig viele Puffer, Textgröße nur durch verfügbaren Speicher begrenzt 

• beliebige, persistente Marken 

• Fehlerlisten-Unterstützung für alle Compiler und Assembler 

• eingebautes Make-Utility 

• geeignet für alle Sprachen von Assembler über C bis Cluster etc. 

• Workbench- und Shell-fähig 

• Steuerung über Tastatur und Maus 

• wählbare Backup-Modi 

• komfortables Blocklegen per Maus, umfangreiche Blockoperationen und perma¬ 
nent sichtbarer Block 

• schnelle Such- und Ersetzoperationen mit vielen Optionen 

• Fließtextunterstützung 

• automatisch ladbare Voreinstellungsdatei 
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2.2 Starten des Editors 

Der HiTex-Editor läßt sich sowohl von einer Shell als auch von der Workbench aus 

starten. Dabei können jeweils beim Start gleich Dateien als Puffer eingeladen werden. 

2.2.1 Start von einer Shell 

Die Syntax für den Shell-Start lautet: 

Editor FILES/M SCREEN/K PORTNAME/K PREFS/K STARTUP/K SETUP/K 

Dabei haben die Argumente genau die Standardform wie unter Amiga-DOS üblich 

(siehe auch Amiga-DOS-Handbuch). Die einzelnen Argumenttypen gliedern sich wie 

folgt auf: 

FILES/M Es dürfen soviele Dateinamen angegeben werden wie gewünscht. Jede an¬ 
gegebene Datei wird als Puffer gleich beim Start in den Editor geladen. Die Da¬ 
teinamen dürfen auch die üblichen Amiga-DOS-Patterns haben, z.B. lädt Editor 
#?.txt ReadMe die Datei namens ReadMe sowie alle Dateien, die die Endung 
>.txt< besitzen. Der Dateiname muß in Amiga-DOS-Manier wie gewohnt ange¬ 
geben werden, d.h., der String »a**b ist c< repräsentiert die Datei a*b ist c. Die 
geladenen Dateien haben als Heimatverzeichnis zuerst das aktuelle Verzeichnis 
der Shell. 

SCREEN/K Der Editor kann auf dem Workbench-Screen oder einem eigenen Screen 
laufen. Hiermit wird der Screenname angegeben, auf dem der Editor seine Fenster 
öffnen soll. Falls ein Public-Screen mit diesem Namen existiert, läuft der Editor 
auf diesem, ansonsten öffnet er einen eigenen Screen. Siehe auch Kapitel 2.9 über 
die Preferences. 

PORTNAME/K Dies ist das Präfix (d.h. der Anfang) des Namens des ARexx- 
Hauptports, der verwendet werden soll. Jedes ARexx-unterstützende Programm 
benötigt einen Port, an dem Meldungen ankommen. Wird dieses Argument nicht 
angegeben, dann wird »HITEX.AREXX.« als Präfix verwendet. Der Editor be¬ 
kommt als Hauptportnamen denjenigen, der aus dem Präfix und der Anzahl 
bereits laufender HiTex-Editoren gebildet wird. Wenn z.B. bereits zwei HiTex- 
Editoren auf dem Rechner laufen, bekommt der dritte den Hauptportnamen 
»HITEX.AREXX.3«. Ein mit PORTNAME angegebenes Präfix könnte hier z.B. 
zum Namen »MeinEditor3< führen. Bitte beachten Sie, (laß nach Commodore- 
Empfehlung der ARexx-Portname vollständig in Großbuchstaben verfaßt sein 
sollte und keine Leerzeichen enthalten darf. 

PREFS/K Mit diesem Argument kann eine Preferencedatei angegeben werden, aus 
der der Editor beim Start seine Standardeinstellungen liest. Welche Standardein¬ 
stellungen existieren, entnehmen Sie bitte dem Kapitel über die Preferences. Falls 
dieses Argument nicht angegeben ist, versucht der Editor, eine Datei namens Hi¬ 
Tex.prefs aus dem aktuellen Verzeichnis zu holen. Gelingt dies nicht, probiert er 
es noch einmal mit der Datei ACOM:HiTex.prefs. Falls diese auch nicht existiert, 
dann werden die internen Voreinstellungen benutzt. 
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STARTUP/K Dies ist der Name eines ARexx Programmes, das gleich nach dem 
Einlesen aller Puffer ausgeführt werden soll (siehe auch Kapitel 2.7 über AR- 
exx). STARTUP kann z.B. dafür verwendet werden, den Editor mit Hilfe eines 
ARexx-Programmes für bestimmte Editiermodi einzustellen, die vom der norma¬ 
len Preference-Einstellung abweichen. Wie beim Befehl EXECAREXXMACRO 
beschrieben, sollte das mit STARTUP angegebene ARexx-Programm in seinem 
Namen keine Leerzeichen enthalten, da sonst u.U. das Programm nicht gefunden 
wird (dies ist ein schwerer Nachteil von ARexx). Falls STARTUP nicht ange¬ 
geben ist, versucht der Editor, eine Datei namens HiTex.hit aus dem aktuellen 
Verzeichnis auszuführen. Gelingt dies nicht, probiert er es noch einmal mit der 
Datei ACOM:HiTex.hit. Dies ermöglicht es Ihnen, weitergehende Konfigurationen 
einzustellen als mit den Preferences und der Setup-Datei (siehe auch Kapitel 2.10 
über die Editorkonfiguration). 

SETUP/K Dies ist eine Setup-Datei wie in Kapitel 2.10 beschrieben. Sie enthält, die 
Konfiguration des Editors für Menüs und Tasten. Genauere Information findet 
sich im genannten Kapitel. 

2.2.2 Start von der Workbench 

Sie starten den Editor von der Workbench aus, indem Sie einfach sein Icon doppelt 
anklicken. Möchten Sie, daß der Editor gleich Dateien als Puffer einliest, dann benutzen 
Sie die erweiterte Auswahl der Workbench. Dabei klicken Sie die Icons der zu ladenden 
Dateien bei gedrückter Shift-Taste einmal an und starten bei immer noch gedrückter 
Shift-Taste den Editor durch Doppelanklicken seines Icons. Jeder Puffer hat dann als 
Heimatverzeichnis das Verzeichnis, aus dem er geladen wurde. 

Sie können einem Icon einer Textdatei auch den Editor als Default-Tool angeben (siehe 
Amiga-Benutzerhandbuch), dann sind Sie aber bei einem Einzelklick auf das Icon nicht 
in der Lage, mehrere Texte beim Start einzuladen. Der Editor speichert als Default-Tool 
in seinen Icons die Datei ACOM:Editor (siehe hierzu auch Installation). Als Tooltype- 
Einträge im Icon des HiTex-Editors gibt es die folgenden: 

SCREEN=<name> Wie SCREEN beim Shell-Start. 

PORTNAME=<name> Wie PORTNAME beim Shell-Start. 

PREFS=<name> Wie PREFS beim Shell-Start, allerdings versucht der Editor, die 
Datei HiTex.prefs zuerst aus dem Verzeichenis zu laden, aus dem er selber geladen 
wurde. Erst dann geht es mit ACOM:HiTex.prefs weiter. 

STAR.TUP=<name > Wie STARTUP beim Shell-Start. 

SETUP=<name> Wie SETUP beim Shell-Start. 

Ferner unterstützt der Editor Workbench-AppWindows, d.h., wenn ein Icon eines Tex¬ 
tes von der Workbench auf einem Editorfenster losgelassen wird, lädt der Editor diesen 
Text als neuen Puffer ein. Dies funktioniert allerdings nicht, solange ein modales Fenster 
geöffnet ist (Ausnahme siehe Filerequester). 
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2.2.3 Nach dem Start 

Noch vor dem Öffnen des ersten Fensters versucht der Editor, eine Preferencedatei 
wie unter PREFS beschrieben einzuladen, um die benutzergewünschte Konfiguration 
herzustellen. Völlig analog dazu wird - wie unter SETUP beschrieben - außerdem eine 
Datei namens HiTex.Setup zuerst über die evtl, angegebene Startoption und dann im 
aktuellen Verzeichnis des Editors bzw. im ACOM:- Verzeichnis gesucht und geladen, die 
die Konfiguration der Menüs und Tastaturkommandos bestimmt (siehe auch Kapitel 
2.10 über die Editorkonfiguration). 

Zudem wird ein Standard-Icon namens ACOIVLHiTex.default.info eingelesen, das für 
Texte ohne Icon abgespeichert wird, sofern das Icon-Abspeichern in den Preferences 
angeschaltet ist (siehe auch Kapitel 2.3.2). 

Falls beim Start keine einzuladenden Dateien angegeben wurden, erzeugt der Editor 
einen Puffer namens »Unnamedl«, damit sofort gearbeitet werden kann. 

Die Tastaturbelegung und -wiederholgescliwindigkeit des Editors ist von den System- 
Preferences abhängig. Dadurch bekommen Sie automatisch ihre nationale Tastatur. 

2.2.4 Startprobleme ? 

Sollte der Editor beim Start einen nicht-fatalen Alert erzeugen, so war es ihm nicht 
möglich, irgendwelche Bibliotheken zu öffnen. Um welche Bibliothek es sich han¬ 
delt, können Sie in den meisten Fällen der Alertnummer entnehmen (siehe Execs C- 
Headerfile exec/alerts.h bzw. Assembler-Includefile exec/alerts.i). Der Editor funktio¬ 
niert erst ab der offiziellen 2.0-Version Kickstart 37.175 und benötigt die Bibliotheken 
DOS, Graphics, Intuition, Icon, Workbench, Diskfont, GadTools und ASL. Weitere 
Startschwierigkeiten meldet der Editor im Klartext, der allerdings nur beim Start, von 
einer Shell erscheint, nicht beim Workbench-Start. 

Sofern nur Textpuffer beim Start geladen wurden, deren WINDOW-Tooltype den Zu¬ 
satz »HIDDEN< haben, werden keine Textfenster geöffnet. Das kann dazu führen, daß 
gar kein Fenster offen ist und Sie gleich einen Request er bekommen, der Sie fragt, ob 
Sie den Editor beenden möchten. Antworten Sie einfach mit »Cancel«, und öffnen Sie 
damit das Pufferlistenfenster. 



18 _ KAPITEL 2. HITEX-EDITOR V3.0 

2.3 Text puffer 

2.3.1 Textpufferfenster 

Jeder Puffer hat ein eigenes Fenster, das aus mehreren Funktionsbereichen besteht. Es 
gibt die Titelzeile, ein oder mehrere Editierbereiche des Textes sowie die Statuszeile 
ganz unten. 

Titelzeile 

Die Titelzeile des Fensters zeigt das Wordwrap-, Overstrike-, TabExpand- und 
Modifikations-Flag sowie den Dateinamen an. Falls der Wordwrap-Modus eingeschaltet 
ist (siehe Kapitel 2.3.4 über Wordwrap), erscheint ein »W« als Anzeige dafür. Falls 
der Overstrike-Modus eingeschaltet ist (siehe Kapitel über 2.3.4 Overstrike), erscheint 
ein »O« als Anzeige. Für den eingeschalteten TabExpand-Modus erscheint schließlich 
ein »T<. 

Es folgt das Modifikationsflag, das anzeigt, ob der Puffertext verändert wurde. Solange 
Sie den Text nicht ändern, erscheint hier ein Minuszeichen. Bei der ersten Änderung 
wechselt die Anzeige in ein Pluszeichen. Der Inhalt eines geänderten Puffers kann nicht 
versehentlich verloren gehen, da der Editor vor dem Pufferlöschen und vor dem Verlas¬ 
sen prüft, ob es einen geänderten Puffer gibt, und in dem Fall eine Sicherheitsabfrage 
macht. Erst wenn ein Puffer in eine Datei geschrieben und damit gesichert wird, kehrt 
das Modifikationsflag zur Minusanzeige zurück. 

Nach dem Modifikationsflag wird der Dateiname des Puffers angezeigt. Beim Shell- 
Start ist dieser mit Dateinamen identisch, den Sie angegeben haben. Beim Workbench- 
Start und beim normalen Nachladen von Dateien ist dies der Name der Datei in dem 
jeweiligen Verzeichnis. Bitte beachten Sie, daß Sie auch absolute Pfadnamen für Dateien 
angeben können, z.B. »RAM:ReadMe<. In dem Fall gehört das Präfix »RAM:< auch 
zum Dateinamen und wird auch so in der Titelzeile ausgegeben. 

Editierbereiche 

Im Fenster selber werden die Editierbereiche des Puffers angezeigt. Ein Editier bereich 
ist ein Ausschnitt aus dem Text des Puffers. Sie können über den Befehl SPLITVIEW 
mehrere Editierbereiche einschalten, die voneinander unabhängig Textausschnitte an- 
zeigen und sich auch überlappen dürfen. Ein Editierbereich ist immer aktiv, er enthält 
den Cursor. Wenn eine Textänderung im aktiven Bereich gemacht wird, stellen auch 
die anderen Bereiche diese Änderung sofort dar, sofern sie den geänderten Textbereich 
anzeigen. 

Die Bereiche werden durch Trennzeilen unterteilt. Jede Trennzeile gehört zu dem über 
ihr stehenden Editierbereich und kann angeklickt und gezogen werden, um die Größe 
ihres Editierbereiches zu ändern. Es ist nicht möglich, einen Editierbereich kleiner als 
eine Textzeile zu machen. Die Höhe der Trennzeilen ist über die Preferences einstellbar. 
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Anklicken einer Trennzeile aktiviert auch ihren Editierbereich. Die Größe eines Editier¬ 
bereiches ist auch über die Befehle GROWVIEW und SHRINKVIEW einstellbar. 

Zwischen den Editierbereichen kann durch Hineinklicken oder über die Befehle NEXT- 
VIEW bzw. PREVVIEW umgeschaltet werden. 

Jeder Editierbereich hat seinen eigenen Scrollbar. Dessen Knopfhöhe entspricht dem 
Anteil der im Editierbereich dargestellten Zeilen an der gesamten Zeilenanzahl des Puf¬ 
fertextes, und seine Knopfposition entspricht immer der Position des Textausschnittes 
innerhalb des Puffertextes. Wenn Sie oberhalb bzw. unterhalb des Knopfes klicken, 
blättert der Editor im Text eine Seite zurück bzw. vor. Durch Ziehen des Knopfes 
können Sie einen beliebigen Textausschnitt anwählen. Der Editor zeigt dabei immer 
den dazugehörigen Textausschnitt an. 

Ein Editierbereich kann mit dem Befehl DELETEVIEW entfernt werden. Der freige¬ 
wordene Platz wird von seinen Nachbarn eingenommen. Es ist bei den Preferences des 
Editors einstellbar, welcher Font zur Textanzeige in den Editierbereichen verwendet 
wird. 

Beachten Sie bitte bei Cursorbewegungen, daß abhängig von der Größe des Editierbe¬ 
reiches das Scrollen bereits früher beginnen kann. Der Editor hat jeweils oben, unten, 
links und rechts einen Bereich, den man normalerweise nicht erreicht, ohne das Scrollen 
auszulösen. Dieser Bereich wird als scrollsensitiver Bereich bezeichnet und bietet den 
Vorteil, daß Sie auch noch ein bißchen von dem Text sehen, der als nächstes vom Cursor 
erreicht wird. 

Statuszeile 

Die Statuszeile befindet sich unter dem letzten Editierbereich. Sie zeigt für den aktiven 
Editierbereich an, in welcher Zeile und Spalte sich der Cursor befindet. Die erste Zeile 
eines Textes hat Nummer Eins, die erste Spalte ganz links hat Nummer Null. Hinter 
der Spaltenanzeige gibt der Editor Meldungen aus, die sich auf den Puffer beziehen, 
z.B. bei einem Fehler während des Speicherns eines Puffers, daß die geschriebene Datei 
wieder aufgrund von Fehlern gelöscht wurde. 

2.3.2 Icons 

Das Standard-Icon 

Der HiTex-Editor benutzt die Tooltypes der Icondatei eines Textes, um textspezifi¬ 
sche Information abzuspeichern. Falls eine Textdatei beim Laden ein Icon besitzt, holt 
sich der Editor dieses und liest aus den Tooltypes die untenstehenden Werte. Beim 
Abspeichern werden die aktuellen Einstellungen der Werte ebenfalls in die Tooltypes 
geschrieben. Ihm unbekannte Tooltypes läßt der Editor dabei unverändert. 

Hatte ein Textpuffer kein Icon, dann wird nur ein neues für ihn geschrieben, wenn 
die Preferences des Editors entsprechend eingestellt sind (siehe Kapitel 2.9 über die 
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Preferences). Die Form dieses neuen Icons können Sie vorgeben, indem Sie eine Icon¬ 
datei namens ACOM:HiTex.default.info erzeugen. Beim Editorstart wird dieses Icon als 
Standard-Icon eingelesen. Beachten Sie dabei, daß Sie als Default-Tool des Icons den 
Dateinamen ACOM:Editor angeben, den Typ auf »Project« stellen und die Position 
nicht festlegen. Gibt es das obige Standard-Icon nicht als Datei, dann verwendet der 
Editor ein internes Standard-Icon. 

Icon-Tooltypes 

Die dem Editor bekannten Tooltypes sind: 

TABULATOR=zahl 
LEFTMARGIN=zahl 
RIGHTMARGIN=zahl 
P0SITI0N=zeile,spalte 
WIND0W=x,y,breite,höhe,hidden 
FLAGS=WT 

MARK=zeile,spalte,name 

Beim Laden werden die Werte entsprechend gesetzt. TABULATOR,, LEFTMARGIN 
und RIGHTMARGIN werden u.a. bei den Preferences beschrieben. POSITION ist die 
Position des Cursors beim Speichern. WINDOW bezieht sich auf die Fenstereinstellung. 
Falls während des Befehls OPENNEWFILE oder beim Laden von Dateien während 
des Starts der WINDOW-Tooltype angegeben ist, öffnet sich das Fenster an dieser 
Position mit der entsprechenden Größe (u.TJ. ist der aktuelle Screen zu klein, und 
das Fenster wird entsprechend angepaßt), sofern die »hidden«-Angabe fehlt. FLAGS 
spiegelt die Einstellung der Flags Wordwrap und TabExpand wieder. MARK kann 
mehrfach Vorkommen und ist eine gespeicherte Marke (siehe unten). Der Markenname 
gilt vom zweiten Komma an bis zum Zeilenende. Ein Beispiel: 

MARK=145,16,StarteProgramm 

Der Sachverhalt für den WINDOW-Tooltype ist beim Speichern etwas kompliziert. Gab 
es den Tooltype beim Laden und wird der Puffer gespeichert, bleibt der Tooltype un¬ 
verändert. Wurde vor dem Speichern jedoch der Befehl SNAPSHOT ausgeführt, dann 
wird die Fensterposition und -große gespeichert, die das Textpufferfenster zum Zeit¬ 
punkt von SNAPSHOT hatte, und es wird der Status angehängt, ob das Fenster gerade 
über den Befehl HIDEFILE geschlossen war (»hidden« fehlt, wenn das Fenster offen 
war). Nach dem Befehl IJNSNAPSHOT wird gar kein WINDOW-Tooltype gespeichert, 
das Textfenster für den Puffer hat dann also keine Voreinstellung fürs Laden. 

2.3.3 Marken 

Jeder Textpuffer hat seine eigene Menge von Textmarken, die von denen der anderen 
Puffer unabhängig ist. Marken sind Positionsangaben innerhalb des Textes, die einen 
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symbolischen Namen haben. Man kann Marken setzen, löschen oder anspringen. Eine 
Marke sitzt auf einer Zeile und darin auf einer Spaltenposition und wird beim Einfügen 
oder Löschen von ein oder mehreren Zeichen oder Zeilen automatisch mitverschoben. 
Die Markennamen »S« und »E« sind für Blockstart und Blockende reserviert (siehe 
auch Kapitel über den Block). 

Marken sind persistent, d.h., sie werden beim Schreiben eines Puffers in der zugehörigen 
Icondatei abgespeichert, so daß sie beim erneuten Laden des Textes zur Verfügung 
stehen. Es ist sinnvoll, z.B. die Prozedurnamen eines Quelltextes als Marken zu setzen, 
denn dann können sie einfach durch Klicken im Markenfenster angesprungen werden 
(siehe Kapitel 2.4.3 über das Markenfenster). Zusätzlich zu den Marken gibt es dann 
noch die Spezialmarke »OLDPOSITION« (dies ist die Tooltype-Angabe POSITION), 
die an der Stelle gesetzt wird, an der sich der Cursor beim letzten Schreiben der Datei 
befand. Auch der Block bleibt wegen der Marken »S« und »E« gespeichert und ist 
beim Einladen sofort markiert. 

Während des Editierens kann es Vorkommen, daß Marken ohne Rückmeldung gelöscht 
werden, z.B. wenn Sie mit dem Befehl DELETELINE die gesamte Zeile löschen, in der 
die Marke lag. 

2.3.4 Texteingabe 

Overstrike 

Der Editor befindet sich normalerweise immer im Einfügemodus. Wenn Sie eine Zeichen¬ 
taste drücken, so fügt er das entsprechende Zeichen an der aktuellen Cursorposition ein 
und verschiebt alle rechts vom Cursor stehenden Zeichen und das Zeichen unter dem 
Cursor um eine Position nach rechts. Ist jedoch der Overstrike-Modus eingeschaltet, 
überschreibt das eingegegebene Zeichen das unter dem Cursor stehende, und der Edi¬ 
tor verschiebt nicht. Beim normalen Einfügen meldet der Editor einen Fehler, wenn 
die Zeile zu lang wird. Bitte beachten Sie, daß der Mauszeiger verschwindet, wenn Sie 
Zeichen per Tastatur eingeben. Sobald Sie die Maus bewegen, erscheint er wieder. Das 
Ausschalten des Mauszeigers läßt sich in den Preferences verhindern (siehe dort). 

Um den horizontal sichtbaren Bereich auszudehnen, schiebt der Editor den Text bei 
allen Funktionen automatisch nach rechts oder links (Scrolling). Sie können den Bereich 
auch ausdehnen, indem Sie das Fenster vergrößern. 

TabExpand 

Tabulatorzeichen haben im Text eine besondere Bedeutung. Ist die Tabulatorexpansion 
eingeschaltet (siehe Preferences) und kommt bei der Textausgabe ein Tabulatorzeichen 
vor, so bewirkt dieses, daß die folgenden Zeichen erst ab der nächsten Fabulatorspalte 
auf dem Bildschirm erscheinen. Der Zwischenraum wird gelöscht, und der Cursor über¬ 
springt diesen Raum bei jeder Funktion. Dies können Sie benutzen, um bei Quelltex¬ 
ten Einrückungen mit so wenig Zeichen wie möglich durchzuführen. Die Breite des 
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Zwischenraumes ist. von dem aktuellen Tabulatorabstand abhängig, und bei der Stan¬ 
dardkonfiguration fügt ein Druck auf die Tabulator-Taste ein Tabulatorzeichen an der 
Cursorposition ein, so daß der nachfolgende Text der Zeile auf die nächste Tabulator¬ 
spalte springt. Ferner können am Zeilenanfang automatisch Tabulatorzeichen ergänzt 
werden, siehe »AutoSOLTab« bei Preferences. Haben Sie die Tabulatorexpansion ab¬ 
geschaltet, dann expandiert der Editor keine Tabulatorzeichen im Text, sondern stellt 
sie direkt als Zeichen des eingeschalteten Fonts dar. 

Wordwrap 

Für die Texteingabe existiert noch ein Modus, in dem Fließtext eingegeben werden 
kann: Der Wordwrap-Modus. Er wird über den Befehl SETPREFS ein- oder ausge¬ 
schaltet und bewirkt beim Einfügen oder Löschen von einzelnen Zeichen oder beim 
Befehl FORMATPARAGRAPH, daß der Absatz, in dem sich der Cursor befindet, von 
der Cursorposition an bis zum Absatzende so formatiert wird, daß die Worte genau 
zwischen dem linken und rechten Rand erscheinen. Dabei ist das Absatzende durch 
eine Leerzeile und ein Wort als Einheit von Zeichen definiert, die weder Leer- noch 
Tabulatorzeichen sind. Der Cursor steht nach all dem Verschieben immer noch an der 
Stelle des Wortes, an dem gerade geschrieben wird, auch wenn es auf die Folgezeile 
gerutscht ist. 

Brauchen Sie ein Leerzeichen, das nicht durch Wordwrap getrennt werden soll, dann 
fügen Sie einfach ein sogenanntes hartes Leerzeichen mit dem ASCII-Code $A0 z.B. 
über den Befehl »INSERTASCII $A0« ein. Dieses Zeichen wird wie ein Leerzeichen 
ausgegeben, aber wie ein echtes Zeichen mit Inhalt wie z.B. »a« o.ä. behandelt. Be¬ 
achten Sie dabei aber, daß manche Compiler und Assembler dieses Zeichen nicht verar¬ 
beiten können. Z.B. beim Optimierenden Makro-Assembler ist es nur in Kommentaren 
erlaubt und führt in anderen Fällen zu Fehlern. 

Durch den Wordwrap-Modus kann vermieden werden, daß Ihnen im Eifer des Schreibens 
der Cursor über den rechten Rand gerät und der Text unbündig wird. Dies ermöglicht 
z.B. das bequeme Schreiben von Briefen oder längeren Texten, denn Sie müssen sich 
nie um das Zeilenende kümmern, nur um das Ende eines Absatzes. Dieses Handbuch 
würde übrigens mit Hilfe des Wordwrap-Modus auf dem HiTex-Editor selbst erstellt. 

2.3.5 Der Block und die Maus 

Der Block 

Als Block wird ein markierter Textbereich verstanden, auf den sich Blockoperationen 
beziehen. Ein Block kann z.B. ausgeschnitten und an einer anderen Stelle wieder ein¬ 
geklebt werden. Vielleicht, soll aber auch der durch den Block markierte Ausschnitt 
in eine Datei geschrieben werden. Das Markieren eines Textbereiches wird als Block¬ 
legen bezeichnet. Der gelegte Block ist immer optisch hervorgehoben und somit gut 
erkennbar. 
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Sie können den Block mit Hilfe der Maus (siehe folgende Absätze) oder durch Setzen 
der Marken >S« für Blockstart und »E« für Blockende legen. Beim Legen per Maus 
werden diese beiden Marken automatisch auf die entsprechenden Positionen gesetzt. 
Der Block existiert genau dann, wenn beide Marken im Puffer gesetzt sind. Ob der 
Blockstart im Text tatsächlich vor dem Blockende liegt, ist für die Operationen des 
Editors unerheblich. 

Einfachklick 

Die Maus ist ein wichtiges Hilfsmittel des Editors. Wenn Sie ein Zeichen mit der Maus 
anklicken, wird der Cursor auf diesem positioniert. Damit können Sie auch zwischen 
Editierbereichen hin- und herschalten. 

Doppelklick 

Falls Sie ein Zeichen doppelt anklicken, das keine öffnende oder schließende Klammer ist 
und zu einem Wort gehört, dann wird der Block um das Wort gelegt, auf dem der Cursor 
steht (siehe auch Befehl SELECTWORD). Falls das Zeichen aber eine öffnende bzw. 
schließende Klammer ist, sucht der Editor die dazu passende schließende bzw. öffnende 
Klammer und positioniert den Cursor auf sie (siehe auch Befehl MOVEMATCHBKT. 
Für die Klammersuche sind runde, eckige, geschweifte und spitze Klammern gültig: 

( ) [ ] { > < > 

Diese Funktion erleichtert Ihnen das Überprüfen von Verschachtelungen in Hochspra¬ 
chen, z.B. bei Befehlsblöcken in C oder bei Ausdrücken wie (a*b*(c+a)*((c+d)-d+(a))). 
Falls das doppelt geklickte Zeichen weder ein Wortzeichen noch eine Klammer ist, 
bewirkt der Doppelklick nichts außer dem Vermerk, daß nun auch ein Dreifachklick 
möglich ist. 

Dreifachklick 

Nach einem Doppelklick ist auch ein Dreifachklick möglich. Damit wird der Block wie 
beim Befehl SELECTLINE um die ganze angeklickte Zeile gelegt. Dreifachklick auf 
eine Klammer bewirkt wiederum nur die Klammersuche. Bei mehr als dreimaligem 
Anklicken wird wieder beim Einfachklick begonnen, d.h., es gibt keinen Vierfachklick 
o.ä. Der ganze Text kann mit dem Befehl SELECTALL markiert werden. 

Ziehen der Maus 

Mit der Maus wird bekanntlich gezogen, indem man anklickt und bei gedrückter 
Maustaste den Mauszeiger verschiebt. An der Endposition wird die Taste wieder los¬ 
gelassen. Das Ziehen einer Trennzeile verändert die Größe ihres zugehörigen Editierbe¬ 
reiches. 
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Mit der Maus kann auch ein beliebiger Textausschnitt als Block markiert werden. Dazu 
klicken Sie den Blockstart an und ziehen den Cursor auf das Blockende. Der Editor mel¬ 
det währenddessen, daß er den Block legt, färbt ihn ein und führt ein automatisches 
Scrolling nach oben, unten, rechts oder links durch, falls Sie an den Rand des Editier¬ 
bereiches geraten. Das Scrollen ist umso schneller, je weiter der Mauszeiger von dem 
Editierbereich entfernt ist. Nach dem Loslassen der Maustaste sind die Marken »S« 
und »E« gesetzt, und der Block ist markiert. 

Mittels Ziehen des Scrollbars kann außerdem der Textausschnitt, der in dem entspre¬ 
chenden Editierbereich dargestellt wird, ausgewählt werden. 

2.3.6 Privater ARexx-Port 

Neben dem Hauptport des Editorprozesses besitzt jeder Textpuffer noch einen privaten 
ARexx-Port, dessen Name mit »HITEX.< beginnt und mit einer eindeutigen Zahl zur 
Identifikation endet (z.B. »HITEX.3«), Soll sich ein ARexx-Programm speziell auf 
nur einen Puffer beziehen, dann kann dieser ARexx-Port dafür benutzt werden, die 
Ausführung vom vom Benutzer aktuell gewählten Puffer unabhängig zu machen. Siehe 
auch Kapitel 2.7.1. 


2.4 Hilfsfenster und Requester 

2.4.1 Gemeinsamkeiten und Unterschiede 

Neben den Textpufferfenstern besitzt der Editor noch etliche Hilfsfenster und Reque¬ 
ster. Diese besitzen sogenannte Gadgets zur Eingabe von Werten, darunter Checkboxen, 
Stringfelder, Listen u.ä. Sie öffnen sich i.a. so in der Nähe des Mauszeigers, daß eines 
der Gadgets unter dem Zeiger liegt, damit die Bedienung ohne viel Mausbewegung 
möglich ist und z.B. ein einfacher Mausklick dieses Gadget mit der vom Editor erwar¬ 
teten Standardantwort auslösen kann. Ist ein Hilfsfenster oder Requester in der Größe 
verstellbar, dann öffnet es sich später mit genau der gleichen Größe. 

Ein Hilfsfenster ist nicht-modal, d.h., es kann offenstehen und erlaubt es, andere Fenster 
zu aktivieren und zu benutzen, ohne das Hilfsfenster zu schließen. Die Gadgets eines 
Hilfsfensters besitzen oft Tastaturkürzel. Diese Kürzel sind im Text zum Gadget unter¬ 
strichen, und bei aktivem Hilfsfenster genügt das Drücken der entsprechenden Taste, 
um das Gadget auszulösen. Die verschiedenen Gadgettypen reagieren auf das Kürzel 
wie folgt: 

• Buttons werden ausgelöst. 

• Checkboxes werden zwischen »angewählt« und »nicht angewählt« hin- und 
hergeschaltet. 

• Cycle-Gadgets werden weiter gestellt. Wird aber gleichzeitig die Shift.-Taste 
gedrückt, dann wird zurückgestellt (dies gilt auch beim Anklicken des Gadgets 
mit der Maus bei gedrückter Shift-Taste). 

• Integergadgets und Stringgadgets werden aktiviert. 

Ein Requester ist hingegen modal, d.h., er setzt für alle anderen vor ihm geöffneten 
Fenster und Requester einen Warte-Mauszeiger, blockiert sie und verlangt die Ein¬ 
gabe einer Antwort. Gadgets und Menüs der anderen Fenster sowie ARexx-Befehle 
können währenddessen nicht ausgelöst werden, und erst nach Beantwortung des Re¬ 
quester kann normal weitergearbeitet werden. Die Gadgets eines Requesters befinden 
sich in der untersten Zeile und haben aufwendigere Tastaturkürzel, damit sie nicht 
aus Versehen beim Schnelltippen verschwinden. <Links-Amiga> + <V> bzw. <Links- 
Amiga> + <B> löst das ganz linke bzw. rechte Gadget aus. Darüberhinaus kann mit 
<Links-Amiga> + <Zahlentaste> das Gadget ausgelöst werden, das in der Gadget- 
zeile an der entsprechenden Position steht, z.B. ist <LAmiga>-f<V> dasselbe wie 
<LAmiga> +<1>, und das dritte Gadget von links würde durch <LAmiga> + <3> 
ausgelöst. Requester besitzen nie ein Close-Gadget, damit die Benutzerantwort immer 
eindeutig bleibt. 

Sowohl Hilfsfenster als auch Requester besitzen noch eine Gemeinsamkeit bei String- 
und Integergadget: Mit der Tabulator-Taste kann zum nächsten String-/Integergadget 
weitergeschaltet werden, mit zusätzlichem Shift wird zurückgeschaltet. Da bei einigen 
Fenstern oder Requestern durch Drücken der Return-Taste in einem Stringgadget be¬ 
reits eine Funktion ausgelöst werden kann und dies nicht immer gewünscht ist, weil man 
noch andere Gadgets per Tastatur bedienen möchte, kann aus jedem solchen Gadget 
per Help-Taste herausgekommen werden, ohne die Funktion auszulösen. 
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2.4.2 Das Pufferlistenfenster 

Im Puffer listenfenster ist die Liste aller existierenden Puffer enthalten. Da es ein Hilfs¬ 
fenster ist, darf es neben den Textfenstern aufbleiben, so daß durch einfach Mausklick 
der aktuelle Puffer gewechselt werden kann. Einfaches Anklicken eines Puffernamens in 
der Liste bewirkt nämlich, daß der Puffer mit seinem Fenster nach vorne geholt und 
aktiviert wird. Sollte sein Fenster gerade nicht offen sein, weil der Befehl HIDEFILE 
verwendet wurde, wird das Fenster für ihn geöffnet. Jeder Listeneintrag enthält zuerst 
das Modifikationsflag des Puffers (Plus- oder Minuszeichen), ein Flag, ob das Fenster 
offen ist (Pluszeichen) oder per HIDEFILE geschlossen wurde (Minuszeichen) und den 
Puffernamen. Vor dem Namen steht ein Stern »*«, wenn es der aktuelle Puffer ist.. 
Hinter dem Namen folgt die Größe des Puffers in Bytes, eingefaßt in runden Klam¬ 
mern. Da diese aus Performancegründen nicht ständig mitgeführt wird, muß sie für die 
Puffer bei Bedarf durch Anklicken des Update-Gadgets aktualisiert werden. Schließlich 
folgt der ARexx-Name des privaten Ports für diesen Puffer in geschweiften Klammern. 
Neben dem Update-Gadget. gibt es noch ein Cancel-Gadget, das wie das Close-Gadget. 
das Pufferlistenfenster einfach schließt. 

Das Pufferlistenfenster öffnet sich beim Befehl OPENBUFFERLIST mit seiner alten 
Größe unter dem Mauszeiger. Sollte das Fenster aber bereits offen sein, dann wird es 
einfach nach vorne gebracht, steht also an seiner alten Position und nicht unbedingt 
beim Mauszeiger. 

2.4.3 Das Markenfenster 

Auch das Markenfenster ist ein Hilfsfenster. Es zeigt die gesetzten Marken des ak¬ 
tuellen Textpuffers an. Wird der Puffer gewechselt, ändert sich auch die Anzeige im 
Markenfenster. Einfaches Anklicken einer Marke bewirkt, daß die Marke angesprungen 
und das aktuelle Textfenster aktiviert wird. Mit dem Delete-Gadget. kann eine Marke 
schnell und effektiv gelöscht werden. Dazu muß »Delete« angeklickt werden, woraufhin 
sich der Mauszeiger in ein Löschsymbol ändert. Danach klicken Sie die zu löschende 
Marke an. Haben Sie es sich anders überlegt und wollen doch nicht löschen, klicken 
Sie entweder das Delete-Gadget ein zweites Mal an (der Mauszeiger normalisiert sich 
dann wieder) oder aktivieren irgendein anderes Fenster. Sobald das Markenfenster de¬ 
aktiviert wird, ist der Delete-Modus abgeschaltet und der Mauszeiger wieder normal. 
Neben dem Delete-Gadget gibt es noch ein Cancel-Gadget, das wie das Close-Gadget 
das Markenfenster einfach schließt. 

Das Markenfenster öffnet sich beim Befehl OPENBOOKMARKS mit seiner alten Größe- 
unter dem Mauszeiger. Sollte das Fenster aber bereits offen sein, dann wird es einfach 
nach vorne gebracht, steht also an seiner alten Position und nicht unbedingt beim 
Mauszeiger. 

2.4.4 Der Filerequester 

Alle Funktionen des Editors, die eine Dateinamen-Auswahl benötigen (wie z.B. OPEN- 
FILE oder SAVEPREFS), verwenden dazu den Filerequester. Dieser ist ein Requester 
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im obigen Sinne und blockiert die anderen Fenster. Es ist in den Preferences einstellbar, 
ob ein eigener Filerequester oder der System-Standard-Filerequester verwendet werden 
soll. Da der letztere stark von der Betriebssystemversion abhängt, verweise ich auf die 
entsprechende Beschreibung in der dortigen Dokumentation. Hier wird nur der eigene 
Requester beschrieben. Dieser Filerequester kann Verzeichnisse mit bis zu 65535 Na¬ 
men bearbeiten. Ein solches Verzeichnis wäre unter Amiga-DOS 32 MegaByte groß. 
Der Filerequester hat die Eigenschaft, daß sie während des Einlesens der Namenliste 
beliebig zwischen Gadgets und Verzeichnissen umschalten können. 

Sobald der Requester erscheint, können Sie den Dateinamen im Filename-Gaclget 
editieren. Je nach Funktion kann sich dort schon ein Vorschlag des Editors befinden. 
Wenn Sie dieses Gadget durch Drücken der Return-Taste verlassen, wird der Requester 
beendet und die aufrufende Funktion ausgeführt. Falls der Dateiname leer ist, wird 
die jeweilige Funktion abgebrochen. Um das Beenden des Filerequesters zu verhindern, 
können Sie wie oben erwähnt das Gadget auch per Tabulator- oder Help-Taste verlassen. 

Das Directory-Gadget enthält immer den vollständigen Pfadnamen des aktuellen 
Verzeichnisses. Durch Anklicken des Gadgets und Andern des Namens wird auf das 
angegebene Verzeichnis geschaltet, das Filename-Gadget aktiviert und die Namenliste 
neu erstellt. Falls kein Verzeichnis mit dem Namen existiert, blinkt der Screen einmal, 
und das Gadget wird erneut aktiviert. 

Das Parent-Gadget bewirkt, daß auf das hierarchisch höherstehende Verzeichnis ge¬ 
schaltet wird. Das Filename-Gadget wird aktiviert und die Namenliste neu erstellt. 
Falls es sich bereits um das Wurzelverzeichnis handelt, passiert nichts. 

Das Pattern-Gadget bestimmt das Auswahlmuster und damit, welche Dateien in der 
Liste sichtbar sind. Ein kleiner Nachrichtentext über der Namenliste teilt mit, wieviele 
Dateien unsichtbar sind. Der Inhalt des Pattern-Gaclgets ist auch in den Preferences 
verzeichnet und kann abgespeichert und damit für den nächsten Editorstart verfügbar 
gemacht werden (siehe Kapitel über die Preferences). 

Die Namenliste enthält die sichtbaren Namen des Verzeichnisses, wobei die Verzeich¬ 
nisnamen vor den Dateinamen (diese haben eine Größenangabe) stehen und jeder die¬ 
ser beiden Bereich alphabetisch sortiert ist. Durch Anklicken können Sie auf das ent¬ 
sprechende Verzeichnis schalten, woraufliin die Namenliste neu erstellt wird. Einfaches 
Anklicken eines Dateinamens übernimmt diesen in das Filename-Gadget und aktiviert¬ 
es. Bei einem Doppelklick wird zusätzlich der Requester beendet und die den File¬ 
requester aufrufende Funktion ausgeführt. Der Doppelklick funktioniert nicht bei ab¬ 
speichernden Funktionen wie z.B. SAVEFILEAS oder SAVEMACRO, damit nicht aus 
Versehen eine falsche Datei überschrieben wird. Bei Befehlen wie z.B. SETHOMEDIR, 
die ein Verzeichnis auswählen, sind die Dateinamen in der Namenliste nicht anklickbar. 

In der Driveliste sind alle Volumes, alle mit Assign zugewiesenen Verzeichnisse sowie 
verwendbare Devices alphabetisch sortiert verzeichnet. Anklicken schaltet auf das ent¬ 
sprechende Verzeichnis und aktiviert das Filename-Gadget. Dadurch können Sie in der 
von Ihnen durch Assign gestalteten Umgebung schnell zum Zielverzeichnis gelangen. 

Das Ok-Gadget beendet den Requester und startet die den Requester aufrufende 
Funktion mit dem aktuellen Verzeichnis und dem aktuellen Dateinamen. Das Cancel- 
Gadget erlaubt Ihnen, den Requester zu beenden und die den Requester aufrufende 
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Funktion abzubrechen. Das Gadget mit der Aufschrift »Set home< setzt das Heimat¬ 
verzeichnis für neu erzeugte Puffer wie beim Befehl SETHOMEDIR auf das aktuelle 
Verzeichnis des Filerequesters. 

Bitte beachten Sie, daß Sie den Aufbau der Namenliste zeitweilig anhalten können, 
indem Sie die rechte Maustaste einmal drücken und wieder loslassen. Mit der gleichen 
Aktion können Sie den Auftau fortsetzen. Während des Anhaltens können Sie Namen, 
Devices, den Scrollbar u.ä. auswählen. Falls irgendein Amiga-DOS-Fehler beim Einlesen 
der Namenliste entsteht (z.B. das aktuelle Verzeichnis nicht mehr verfügbar ist, weil 
die Diskette schon herausgenommen wurde), meldet der Filerequester diesen Fehler mit 
seinem Amiga-DOS-Fehlercode in dem Nachrichtentext über der Namenliste und läßt 
die Namenliste leer. 

Der Filerequester erscheint anfangs in der vollen Höhe des sichtbaren Screenbereiches 
und kann in der Größe geändert werden. Er öffnet sich wieder in der Größe, in der 
er verlassen wurde, und mit der Namenliste unter dem Mauszeiger. Eine Besonderheit 
gibt es noch: Wenn ein Workbench-Tcon in den Filerequester gezogen wird, so wird das 
Verzeichnis des Icons und sein Dateiname in den Filerequester eingetragen. 

2.4.5 Das Findfenster 

Das Findfenster ist ein Hilfsfenster. Es wird ausführlich im Kapitel 2.6 über die Such¬ 
funktion beschrieben. 

2.4.6 Die Preferences-Requester 

Die Preferences-Requester sind ausführlich im Kapitel 2.9 über die Preferences beschrie¬ 
ben. 

2.4.7 Der Print-Requester 

Dieser Requester erscheint, solange gedruckt wird. Er enthält nur ein einziges Gadget 
namens »Stop«, das den Druckvorgang abbricht. 

2.4.8 Der Assemble-Requester 

Hier sind die Einstellungen für den residenten Assembler für die Befehle OPENAS- 
SEMBLE und ASSEMBLE enthalten (siehe auch dort). 

2.4.9 Der Modified-Project-Requester 

Dieser Requester erscheint, wenn ein veränderter Puffer gelöscht, geschlossen oder über¬ 
laden o.ä. werden soll. Er fragt, ob der Puffer vor dem Fortfahren gesichert werden soll, 
ob gleich fortgefahren werden soll oder ob die Funktion abzubrechen ist. 
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2.5 Tastatur-Funktionen und Menüs 

Dieses Kapitel beschreibt kurz die Belegung der Tastatur und der Menüs, die in 
der Standardkonfiguration festgelegt ist. Bitte beachten Sie, daß Sie die Editor- 
Konfiguration vollständig selber definieren können, siehe Kapitel 2.10. Die Standard¬ 
konfiguration des Editors ist in der Datei HiTex.prefs enthalten, dort hnden Sie auch 
die Zuordnung der Menüs zu den jeweiligen Befehlen. Die meisten Menüs haben die 
gleiche Namensbezeichnung wie der entsprechende Editor-Befehl. 

Wie oben bereits erwähnt, werden normalerweise Zeichen eingefügt. Ein Tastendruck 
erzeugt das Zeichen, das der Taste durch die Tastaturbelegung zugeordnet ist. Es gibt 
jedoch Spezialtasten (wie z.B. <Return>) und Tastenkombinationen, die andere Aus¬ 
wirkungen haben. Im folgenden ist die jeweilige Wirkung unter der Standardkonfigura¬ 
tion des Editors beschrieben. 

<Shift>+<Keypad-Null> schaltet den Overstrike-Modus ein oder aus (Befehl 
»SETPREFS OverStrike Toggle«), Haben Sie keinen Zahlenblock, sollten Sie die Funk¬ 
tion umbelegen. 

Die Delete-Taste löscht das Zeichen unter dem Cursor und zieht alle rechts vom Cursor 
stehenden Zeichen eine Spalte nach links (Befehl DELETE). Mit <Shift>+<Delete> 
wird auch im Overstrike-Modus ein Leerzeichen an der aktuellen Cursorposition ein¬ 
gefügt (Befehl INSERTSPACE). Hier wird der Wordwrap-Modus beachtet. 

Die Backspace-'laste löscht das Zeichen vor dem Cursor und zieht alle rechts vom 
Cursor stehenden Zeichen und das Zeichen unter dem Cursor eine Spalte nach links 
(Befehl BACKSPACE). Falls der Cursor am Anfang der Zeile steht, wird diese Zeile an 
die vorige angehängt. Würde dadurch eine Zeile mit mehr als 254 Zeichen entstehen, 
meldet der Editor einen Fehler und bricht die Funktion ab. 

Die Return-Taste bewirkt das Teilen der aktuellen Zeile an der Cursorposition und das 
Setzen des Cursors auf den eingestellten linken Rand (Befehl NEW LINE). Es wird also 
eine weitere Zeile erzeugt. Würde dadurch eine Zeile mit mehr als 254 Zeichen entstehen, 
meldet der Editor einen Fehler und bricht die Funktion ab. Wenn Sie die Einstellung 
des linken Randes ändern, rückt der Editor den Cursor anders ein. Mit dem linken und 
rechten Rand können Sie umgehen wie auf einer Schreibmaschine, aber beachten Sie, 
daß der Editor bei eingeschalteter Tabulatorexpansion so viele Tabulatorzeichen (und 
anschließend Leerzeichen) einfügt, wie zum Erreichen des linken Randes notwendig sind. 
Bei ausgeschalteter Expansion werden nur Leerzeichen eingefügt. 

Die Enter-Taste hat die gleiche Funktion wie die Return-Taste. 

Die Help-Taste bewirkt das Teilen der aktuellen Zeile an der Cursorposition. Im Ge¬ 
gensatz zur Return-Taste stellt der Editor hier jedoch fest, wieviel Leer- und Tabu¬ 
latorzeichen in der alten Zeile vor dem ersten Zeichen standen und setzt den Cursor 
auf den gleichen Abstand in der neuen Zeile (Befehl NEW 7 LINEINDENT). Dies wird in 
blockorientierten Sprachen wie C, Modula-2 oder Cluster benötigt, um bequem Instruk¬ 
tionen einzurücken, und wird als Indent-Funktion bezeichnet. Sowohl bei der Help- als 
auch bei der Return-Taste stehen die Zeichen, die auf der alten Zeile hinter bzw. unter 
dem Cursor standen, auch in der neuen Zeile hinter bzw. unter dem Cursor. 
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Die Tabulator-Taste fügt bei eingeschalteter Tabulatorexpansion ein Tabulatorzeichen 
an der aktuellen Cursorposition ein. Bei ausgeschalteter Expansion oder in Verbin¬ 
dung mit der Control-Taste bewirkt sie das Anspringen der nächsten Tabulatorspalte. 
Mit <Shift>+<Tabulator> oder <Control>-|-<Shift>-f-<Tabulator> wird die vorige 
Tabulatorspalte angesprungen, so daß Sie sich schnell innerhalb einer Zeile bewegen 
können. Der Tabulaturabstand ist wählbar (siehe Preferences). 

Die Umschalttasten Shift, Alternate, Control und Amiga alleine haben keine Funk¬ 
tion. Mit der rechten Amiga-Taste kürzen Sie die Menüs wie gewohnt ab (sogenannte 
Shortcuts), z.B. ruft <Amiga>+<V> dem Befehl PASTE auf. 

Die Funktionstasten können Sie beliebig mit Makroaufrufen belegen, d.h., es wird je¬ 
weils ein ARcxx-Skript ausgeführt. 

Die Cursortasten funktionieren je nach Tastenkombination unterschiedlich: 

• Alleine gedrückt ist es die normale Cursorbewegung nach oben, unten, links und 
rechts (mit automatischem Scrolling). 

• Mit <Shift> geht der Cursor auf: 

<Cursox’-up> das erste Zeichen der obersten, sichtbaren Zeile, die noch nicht 
zum scrollsensitiven Bereich gehört. 

<Cursor-down> das erste Zeichen der untersten, sichtbaren Zeile, die noch 
nicht zum scrollsensitiven Bereich gehört. 

<Cursor-left> das erste Zeichen der aktuellen Zeile. 

<Cursor-right> das letzte Zeichen der aktuellen Zeile. 

• Mit <Alternate> wird bei <Cursor-left> und <Cursor-right> der Text unter 
dem Cursor verschoben, ohne die Cursorposition auf dem Bildschirm zu verlas¬ 
sen. <Alternate>-|-<Cursor-up> ruft den Befehl »PREVIOUS Page« auf und 
<Alternate> + <Cursor--up> den Befehl »NEXT Page«. 

• In Verbindung mit der Control-Taste bewirken <Cursor-left> und <Cursor- 
right> die Befehle »PREVIOUS Word« und »NEXT Word«. 

• In Verbindung mit <Control> + <Shift> bewirkt <Cursor-up> den Befehl 
»POSITION SOF« und <Cursor-down> den Befehl »POSITION EOF«. 


2.6 Such-Funktion 

2.6.1 Das Findfenster 

Der Editor besitzt eine schnelle Suchfunktion, um Strings (d.h. Textteile) in Texten 
zu linden. Gefundene Strings können Sie durch alternative Ersetzstrings austauschen 
lassen. Gesucht wird grundsätzlich ab der aktuellen Cursorposition. Um Such- und 
Ersetzstrings eingeben zu können, gibt es das Findfenster. Es wird mit dem Befehl 
OPENFIND geöffnet und kann auch nach Ende des Suchens offengelassen werden. 
Beim Aufruf der Suchfunktion wird immer die aktuelle Einstellung des Findfensters 
verwendet, und die Suchoperationen bezieht sich auf das aktuelle Textfenster. Das 
Findfenster hat die folgenden Gadgets: 

Find-Gadget: Es erlaubt die Eingabe des Suchstrings, welcher Wildcards (siehe un¬ 
ten) enthalten darf. Mit der Tabulator-Taste wird das Changetext-Gadget ak¬ 
tiviert, und mit der Help-Taste wird das Find-Gadget deaktiviert. Drücken Sie 
die Return-Taste im Find-Gadget, dann wird das Findfenster geschlossen und 
eine einfache Suchaktion gestartet. Das rechts vom Find-Gadget stehende Cvcle- 
Gadget ermöglicht es, interaktiv zwischen fünf verschiedenen Suchstrings zu 
wählen. Der sichtbare Suchstring wird verwendet. Damit muß bei zwischenzeit¬ 
lichem Wechsel der ursprüngliche Suchstring nicht erneut eingegeben werden. 
Wird das Gadget mit gedrückter Shift-Taste angeklickt, schaltet es rückwärts. 

Changetext-Gadget: Hier wird der Ersetzstring eingegeben. Mit der Tabulator- 
Taste wird das Find-Gadget aktiviert, und mit der Help-Taste wird das 
Changetext-Gadget deaktiviert. Drücken Sie die Return-Taste im Changetext- 
Gadget, dann wird die Suchaktion gestartet, ohne daß das Findfenster geschlos¬ 
sen wird. Das rechts vom Changetext-Gadget stehende Cycle-Gadget ermöglicht 
es, interaktiv zwischen fünf verschiedenen Ersetzstrings zu wählen. Der sicht¬ 
bare Ersetzstring wird verwendet. Wird das Gadget mit gedrückter Shift-Taste 
angeklickt, schaltet es rückwärts. 

IgnoreCase-Gadget: Wenn die Checkbox markiert ist, dann wird bei der Suche 
nicht zwischen Groß- und Kleinschreibung unterschieden, d.h., der Suchstring 
»Motor« wird auch im Text »Otto-MOTOR« gefunden. Ist die Checkbox nicht 
markiert, werden Groß- und Kleinbuchstaben bei der Suche als verschieden an¬ 
gesehen. 

OnlyWholeWord-Gadget: Wenn die Checkbox markiert ist, wird der Suchstring 
nur gefunden, wenn er als eigenständiges Wort steht. Dabei wird die Preference- 
Einstellung »Complex Words« berücksichtigt. Als Beispiel würde der Suchst ring 
»ich« im Text »dich und mich« nicht gefunden, wenn diese Option eingeschaltet 
ist. 

ScanBackward-Gaclget: Wenn die Checkbox markiert ist, dann wird rückwärts ge¬ 
sucht. Keine Markierung heißt vorwärts suchen. 

StringFromBlock-Gadget: Dieses Gadget übernimmt den aktuellen Block als Such¬ 
string. Dazu muß dieser auf einer einzigen Zeile sein und maximal 127 Zeichen 
haben (sonst wird ein Fehler gemeldet). Wenn Sie in Ihren Quelltexten nach 
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einem Begriff suchen, der gerade in dem Text steht, können Sie somit das ent¬ 
sprechende Wort doppelt anklicken (und damit den Block um dieses W 7 ort legen) 
und anschließend durch Anklicken dieses Gadgets den Suchstring entsprechend 
setzen. 

FindNext-Gadget: Bei Anklicken dieses Gadgets sucht der Editor nach dem nächsten 
Vorkommen des Suchstrings in der gewählten Richtung und springt diese Position 
an. 

Cliange-Gadget: Dieses Gadget ist nur eingeschaltet, wenn gerade ein Vorkommen 
des Suchstrings gefunden wurde. Mit seiner Anwahl wird das aktuelle Vorkommen 
durch den Ersetzstring ersetzt und nach dem nächsten Vorkommen gesucht. 

ChangeAll-Gadget: Mit diesem Gadget werden unsichtbar alle Vorkommen des 
Suchstrings in der gewünschten Suchrichtung ohne Rückfrage durch den Ersetz¬ 
string ersetzt. Der Editor meldet dann, wie oft er den Suchstring ausgetauscht 
hat. 

Das Findfenster ist so angelegt, daß ein Begriff sehr einfach gesucht werden kann. Offnen 
Sie das Findfenster, geben Sie den Suchstring ein und drücken Sie danach die Return- 
Taste. Das Findfenster verschwindet, und die Suche beginnt. Falls das Findfenster offen 
bleiben soll, drücken Sie zuerst die Tabulator-Taste (das Changetext-Gadget wird aktiv) 
oder die Help-Taste (das Find-Gadget wird deaktiviert) und danach erst die Return- 
Taste. Es gibt außerdem den Befehl FIND, der es mit seinen Optionen erlaubt, den 
Suchtext erneut zu suchen, ohne das Findfenster zu benutzen (siehe ARexx-Befehle). 
Die Standardkonfiguration des Editors enthält solchermaßen realisierte Menübefehle 
für die Suche. Natürlich können Sie auch die Befehle auf Funktionstasten oder andere 
Tasten legen. 

Möchten Sie mit Sichtkontrolle ersetzen, so starten Sie die Suche ohne Schließen des 
Findfensters und betätigen danach nur das FindNext- bzw. Change-Gadget, um Erset¬ 
zung zu überspringen bzw. auszulösen. 


Editor den String »Otto*motor« hndet, wenn er »Otto« findet und irgendwo auf 
der gleichen Zeile nachfolgend (bzw. vorhergehend beim Suchen rückwärts) das W 7 ort, 
»motor« vorkommt. Deshalb die folgende Warnung: 

DIE WILDCARDS KÖNNEN ERHEBLICHEN SCHADEN ANRICH¬ 
TEN, WENN SIE BEIM ERSETZEN MIT »CHANGE ALL« VER¬ 
WANDT WERDEN! BENUTZEN SIE DAHER DAS INTERAKTIVE ER¬ 
SETZEN. 

2.6.3 Besonderheiten 

Die Suchfunktion bietet viele Möglichkeiten der Textbearbeitung, da Sie in den String¬ 
komponenten Control-Sequencen direkt eingegeben können. Vorausssetzung dafür ist 
allerdings, daß Sie im System-Preference-Programm IControl den Text-Gadget-Filter 
ausgeschaltet haben. Dann können Sie ein Tabulatorzeichen z.B. über den Suchstring 
<Control>+<I> oder ein sogenanntes hartes Leerzeichen (ASCII-Code $A0, erscheint 
als Leerzeichen, hat aber anderen Code) über <Alternate>-)-<Leertaste> suchen. 

Ein Zeilenende (eine Zeile endet mit einem Linefeed, $0A) können Sie finden lassen, 
indem Sie beim Suchstring <Control> + <J> (entsprechend dem Linefeed-Code) ein¬ 
geben. Sollten Sie dann ersetzen wollen, müssen Sie den Ersetzstring ebenfalls mit 
<Control>-|-< J> abschließen! Andernfalls kann der Editor die seltsamsten Ak¬ 
tionen vollführen, da er auf ein Linefeed am Zeilenende angewiesen ist. 

Wollen Sie eine Leerzeile finden, geben Sie zweimal <Control> + <J> als Suchstring 
an. Der Editor ist hierbei aber nicht in der Lage zu ersetzen oder rückwärts zu suchen! 
Benutzen Sie zur Verarbeitung einer Leerzeile ein ARexx-Programm. 


2,6.2 Wildcards 

Innerhalb eines Suchstrings dürfen Sie sogenannte Wildcards benutzen, die Platzhalter 
für einen oder mehrere unbekannte Buchstaben sind: 

? steht für genau einen beliebigen Buchstaben. 

* steht für eine beliebig lange Zeichenkette, die auch die Länge 0 haben kann. Die 

Länge ist allerdings durch die maximale Zeilenlänge von 254 Zeichen beschränkt. 

Es handelt es sich nicht um die gleichen Wildcards wie bei Amiga-DOS! Falls Sie die 
Zeichen »?« und »*« und den Backslash »\« selber suchen möchten, müssen Sie 
ihnen einen Backslash voranstellen. In einem Ersetzstring werden diese drei Zeichen 
wie normale Zeichen behandelt, sie haben dort also keine besondere Bedeutung. 

Lautet der Suchstring z.b. »W?lle«, wird der Editor sowohl »Welle« als auch »Wolle« 
oder »Wille« finden. Die Wdldcard »*« ist in der Benutzung etwas heikel, da der 
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2.7 ARexx 

ARexx ist die Skript-Programmiersprache, die seit Kickstart 2.0 jedem Amiga beiliegt. 
Mit ARexx ist es möglich, Programme von außen zu steuern, ohne daß der Benutzer ein¬ 
zugreifen braucht. Damit lassen sich auf den Grundfunktionen des Editors aufbauend 
beliebig komplexe Operationen realisieren. Da sich der Editor zudem frei konfigurie¬ 
ren läßt, kann eine solche Operation sogar einfach durch Tastendruck vom Editor aus 
aufgerufen werden. 

Solange Sie den Editor nur normal benutzen möchten, brauchen Sie sich nicht um 
ARexx zu kümmern. Als erfahrener Benutzer werden Sie ARexx aber bald intensiv 
benutzen. In diesem Kapitel wird vorausgesetzt, daß Sie das ARexx-Kapitel im Amiga- 
Benutzerhandbuch gelesen haben und sich mit den Grundlagen und der Form von 
ARexx auskennen. 


2.7.1 ARexx-Ports 

Der Hauptport 

Jedes Programm, das ARexx unterstützt, benötigt einen Port, an den ARexx Be¬ 
fehle schicken kann. Der HiTex-Editor besitzt einen Hauptport für diesen Zweck. Da 
mehrere Prozesse vom HiTex-Editor gleichzeitig laufen können, unterscheiden sich die 
Hauptportnamen anhand einer Nummer voneinander. Der Name des Hauptports setzt 
sich aus einem Präfix und einer Nummer zusammen. Das Präfix ist normalerweise 
HITEX.AREXX., kann aber mittels der Startoption PORTNAME anders gewählt wer¬ 
den. Beim Start sorgt der Editor dafür, daß sein Hauptportname im System einzig¬ 
artig bleibt, indem an das Präfix eine Nummer angehängt wird. Wenn z.B. bereits 
zwei HiTex-Editoren auf dem Rechner laufen, bekommt der dritte den Hauptportna¬ 
men HITEX.AREXX. 3. Es ist wichtig zu beachten, daß nach Commodore-Empfehlung ein 
ARexx-Portname vollständig in Großbuchstaben verfaßt sein sollte und keine Leerzei¬ 
chen enthalten darf, ansonsten wird der Port u.U. von ARexx nicht gefunden. 

Der Name des ARexx-Hauptports erscheint im Copyright-Requester. Siehe ARexx- 
Befehl COPYRIGHT. 


Der Privatport 

Neben dem Hauptport des Editorprozesses besitzt jeder Textpuffer noch einen privaten 
ARexx-Port, dessen Name mit HITEX. beginnt und mit einer eindeutigen Zahl zur Iden¬ 
tifikation endet (z.B. HITEX. 3). Soll sich ein ARexx-Programm speziell auf nur einen 
Puffer beziehen, dann kann dieser ARexx-Port dafür benutzt werden, die Ausführung 
vom vom Benutzer aktuell gewählten Puffer unabhängig zu machen. Numerisch aufein¬ 
anderfolgende Portnamen können zu verschiedenen Editorprozessen gehören. Der Name 
eines Privatports findet sich im Pufferlistenfenster. 


2.7.2 ARexx-Details 

Befehlsausführung 

Bevor ein Befehl in einem ARexx-Skript an den Editor gesandt wird, muß mit dem 
ARexx-eigenen Befehl >ADDRESS« der Hauptport des Editors oder ein Privatport 
eines Puffers angewählt werden. Wird ein ARexx-Befehl an einen Privatport geschickt, 
dann bezieht sich seine Ausführung auch auf den entsprechenden Puffer, z.B. bei OPEN- 
FILE wird nur in diesen Puffer geladen. Wird ein pufferbezogener Befehl an den Haupt¬ 
port geschickt, arbeitet er auf dem vom Benutzer aktuell eingestellten Puffer. Da dieser 
während der Ausführung eines ARexx-Skripts durch den Benutzer gewechselt werden 
kann und die Befehle dann auf den neuen, aktuellen Puffer wirken, ist somit Vorsicht 
angebracht. 

ARexx kennt für Skriptnamen ein Standardsuffix, so daß der Name eines Skripts in 
einem anderen Skript als Befehl benutzt werden kann. Der HiTex-Editor verwendet als 
Suffix für seine ARexx-Skripts das Suffix >.hit< (siehe auch ARexx-Handbuch). 

Befehle, die eine Rückgabe an das ARexx-Skript haben, geben diese Rückgabe wie 
unter ARexx üblich in der Variablen RESULT zurück. 

ARexx beim Editorstart 

Wie im Kapitel 2.2 beschrieben wurde, versucht der Editor bei fehlender STARTUP- 
Startoption, ein ARexx-Skript namens HiTex.hit aus dem aktuellen Verzeichnis aus¬ 
zuführen. Gelingt dies nicht, probiert er es noch einmal mit dem Skript ACOM:HiTex.hit. 
Dies ermöglicht es Ihnen, weitergehende Konfigurationen einzustellen als mit den Pre- 
ferences und der Setup-Datei (siehe auch Kapitel 2.10 über die Editorkonfiguration). 

2.7.3 Probleme mit ARexx 

Da ARexx die einzelnen Argumente eines Befehls durch Leerzeichen unterscheidet, er¬ 
geben sich einige Probleme. Dazu gehört z.B., daß bei Aufruf eines Makros aus der 
Ram-Disk ihr Volume-Name keine Leerzeichen enthalten darf (siehe auch Befehl EXE- 
CAREXXMACRO). Zudem müssen Strings, die als Argumente übergeben werden und 
Leerzeichen enthalten, doppelt in Hochkommata eingefaßt werden, sonst erscheinen die 
einzelnen Worte des Strings ungetrennt voneinander bei dem Programm, das den Befehl 
ausführen soll. Beispiel: Die beiden Befehle 

RequestNotify ’Der Titel’ ’Der innere Text’ 

RequestNotify "Der Titel" "Der innere Text" 

erscheinen beim Programm als 

RequestNotify Der Titel Der innere Text 

Nun sind aber die beiden Strings nicht mehr voneinander unterscheidbar. Korrekt sind 
die Schreibweisen 
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RequestNotify ’"Der Titel" ’ '"Der innere Text"’ 

’RequestNotify "Der Titel" "Der innere Text"’ 

ARexx entfernt die einzelnen Hochkommata, und die doppelten bleiben für das Pro¬ 
gramm sichtbar. Bei ihm erscheint der Befehl dann korrekt als 

RequestNotify "Der Titel" "Der innere Text" 

2.7.4 ARexx-Befehle zur Pufferverwaltung 

Im folgenden sind alle ARexx-Befehle aufgeführt, die der HiTex-Editor versteht. Das 
Befehlswort ist immer das erste Wort, und die Argumente sind als Schablonen wie bei 
Amiga-DOS üblich angegeben. Die Befehle sind thematisch geordnet und erscheinen 
alle im Stichwortverzeichnis. 

OPENBUFFERLIST 

Öffnet das Pufferlistenfenster bzw. bringt es nach vorne, wenn es schon offen ist. 

NEWFILE HIDDEN/S, PORTNAME/F 

Erzeugt einen neuen Puffer und gibt den ARexx-Privatportnamen mit angehäng¬ 
ter Nummer für die Eindeutigkeit zurück. PORTNAME kann den Portnamen 
fest spezifizieren, dabei wird keine Nummer angehängt. Als Verzeichnis bekommt 
der Puffer das Heimatverzeichnis des Editors. Falls HIDDEN angegeben ist, wird 
für den Puffer anfangs kein Fenster geöffnet. 

OPENFILE FILENAME, QUIET/S 

Lädt eine Datei in den Puffer. Wenn FILENAME nicht angegeben wird, erscheint 
der Filerequester. QUIET unterdrückt den Modified-Project-Requester. Falls in 
einem Requester Cancel gewählt wird, ist der Rückgabecode 5. Da der Editor 
keine Zeilen von mehr als 254 Zeichen Länge verarbeiten kann, teilt er solche 
Zeilen beim Laden auf und meldet dies. Sollte genau dieser Text bereits in einem 
Puffer sein, so fragt der Editor nach, ob er wirklich noch einmal geladen werden 
soll. Falls nicht, bricht er das Laden ab und schaltet den betroffenen Puffer in 
den Vordergrund. 

OPENNEWFILE FILENAME, HIDDEN/S, PORTNAME/K 

Erzeugt einen neuen Puffer, lädt gleich eine Datei hinein und gibt den ARexx- 
Privatportnamen mit angehängter Nummer für die Eindeutigkeit zurück. PORT¬ 
NAME kann den Portnamen fest spezifizieren, dabei wird keine Nummer an¬ 
gehängt. Wenn FILENAME nicht angegeben wird, erscheint der Filerequester. 
Falls Cancel gewählt wird, ist der Rückgabecode 5. Falls HIDDEN angegeben 
ist, wird für den Puffer anfangs kein Fenster geöffnet. 

SAVEFILE NOBACKUP/S, NOICON/S 

Schreibt den Puffer in eine Datei. Wenn der aktuelle Puffername leer ist, wird 
er zuerst über den Filerequester abgefragt. Falls Cancel gewählt wird, ist der 
Rückgabecode 5. NOBACKUP unterdrückt auf jeden Fall die Erstellung eines 
Backup, NOICON unterdrückt entsprechend das Erzeugen eines Icons. Weitere 


2.7. AREXX _ 37 

Information zum Backup einer Datei findet sich im Kapitel über die Prcfercnccs. 
Falls alles gut geht, setzt der Editor das Modifikationsflag des Puffers zurück, 
da der Text ja gesichert wurde. 

SAVEFILEAS FILENAME, NOBACKUP/S, NGICON/S 

Schreibt den Puffer unter dem FILENAMEn in eine Datei und ändert den Puffer¬ 
namen auf den angegebenen Namen. Wenn es keinen FILENAMEn gibt, wird 
er zuerst über den Filerequester abgefragt. Falls Cancel gewählt wird, ist der 
Rückgabecode 5. NOBACKUP und NOICON arbeiten wie bei SAVEFILE. 

SAVEMODIFIEDFILES QUIET/S 

Schreibt alle veränderten Puffer in ihre Dateien. Wenn QUIET nicht angege¬ 
ben ist, wird vor dem Schreiben für jeden veränderten Puffer gefragt, ob er 
tatsächlich geschrieben werden soll. Die Antwort kann »Yes«, »No<, »Save 
alle, »Save none« oder »Cancel« sein. Sollte »Save all« geantwortet werden, 
wird die Abfrage nicht mehr durchgeführt, sondern es werden alle Puffer ge¬ 
schrieben. »Save none« schreibt keinen der Puffer, und »Cancel« bricht die 
Funktion mit Rückgabecode 5 ab. »Save none« kommt beim Befehl QUIT ins 
Spiel, wenn der Editor beendet werden soll, ohne eine Datei abzuspeichern. 

SAVEFILEQUIT QUTF.T/S 

Schreibt den Puffer und führt dann QUIT aus. QUIET unterdrückt den 
Modified-Project-Requester für die anderen Puffer. 

SETFILEPATH FILENAME/F 

Ändert den Puffernamen. Wenn es keinen FILENAMEn gibt, wird er zuerst über 
den Filerequester abgefragt. Falls Cancel gewählt wird, ist der Rückgabecode 5. 

SETCURRENTDIR DIRNAME/F 

Setzt das Verzeichnis des Puffers. Wenn DIRNAME fehlt, erscheint der Filere¬ 
quester. Falls Cancel gewählt wird, ist der Rückgabecode 5. Das Verzeichnis ist 
der Identifikatorname eines Puffers, der nicht im Fenstertitel sichtbar ist. 

SETHOMEDIR DIRNAME/F 

Setzt das Heimatverzeichnis des Editors. Wenn DIRNAME fehlt, erscheint der 
Filerequester. Falls Cancel gewählt wird, ist der Rückgabecode 5. Das Heimat¬ 
verzeichnis bestimmt, mit welchem Verzeichnis ein neu erzeugter Puffer beginnt. 

SETSAVEDATE 

Setzt das Datum für einen abzuspeichernden Puffer auf die aktuelle Zeit. Wird 
der Puffer vor dem Abspeichern noch einmal verändert, hat die Datei das Datum 
der Abspeicherzeit, sonst hat sie das Datum des SETSAVEDATE-Zeitpunkts. 
Diese Funktion ist im Zusammenhang mit einem externen Compiler sinnvoll, da 
zwischendurch compiliert und der Text erst später abgespeichert werden kann, 
ohne daß das Dateiendatum erneut gesetzt wird und ein Make-Utility denkt, der 
Quelltext müsse erneut übersetzt werden. 

CLEARSAVEDATE 
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Löscht das obige Datum. Die Datei des Puffers wird das Datum der Abspeicher¬ 
zeit haben. 

SNAPSHOT ALL/S 

Legt für den Puffer fest, daß die Fensterposition und -große beim Speichern 
als WINDOW-Tooltype in das Icon gespeichert wird. Mit ALL betrifft dies alle 
Textpuffer. Erst nach diesem Befehl können also neue Fensterwerte z.B. durch 
den Befehl SAVEFILE in das Icon des Puffers gelangen. Siehe auch Kapitel 
2.3.2. 

UNSNAPSHOT ALL/S 

Legt für den Puffer fest, daß die Fensterposition und -große beim Speichern nicht 
mehr als WINDOW-Tooltype in das Icon gespeichert wird. Dies bedeutet aber 
auch, daß überhaupt kein WINDOW-Tooltype geschrieben wird, der Puffer hat 
also nach dem Speichern keine Fensterwerte mehr. Mit ALL betrifft dies alle 
Textpuffer. Siehe auch Kapitel 2.3.2. 

MAKE FILENAME/F 

Ruft das interne Make-Utility auf. FILENAME ist der Name des zugrundeliegen¬ 
den Makefiles. Wenn FILENAME nicht angegeben ist, wird makefile als Name 
verwendet. Siehe auch Kapitel 2.8 über Make. 

CLOSEFILE QUIET/S 

Schließt den Puffer mitsamt Fenster. QUIET unterdrückt den Modified-Project- 
Requester. Falls Cancel gewählt wird, ist der Rückgabecode 5. 

PRINTFILE 

Druckt den Pufferinhalt über das Printer-Device. Es erscheint der Print- 
Requester. Das Drucken kann durch Anklicken des Stop-Gadgets im Print- 
Requester abgebrochen werden. 

CLEARFILE QUIET/S 

Löscht den Pufferinhalt, läßt das Fenster aber offen. QUIET unterdrückt den 
Modified-Project-Requester. Falls Cancel gewählt wird, ist der Rückgabecode 5. 

HIDEFILE 

Schließt das Fenster eines Puffers, ohne den Puffer zu entfernen oder seinen 
Inhalt zu löschen. Der Puffer ist weiterhin vorhanden und kann durch Anklicken 
im Pufferlistefenster oder durch den Befehl ACTIVATEDOC erneut geöffnet 
werden. 

QUIT QUIET/S 

Beendet den Editor. Falls ein Puffer noch verändert ist, kommt ein Requester 
hoch, der mit QUIET unterdrückt werden kann. Dieser Requester ist derselbe 
wie bei SAVEMODIFIEDFILES. »Save none« beendet hier den Editor, ohne 
irgendeinen Puffer abzuspeichern, »Cancel« hingegen bricht die Funktion ab 
und läßt den Editor weiterlaufen. 


2.7.5 ARexx-Befehle zur Blockverwaltung 

CUTBLK 

Schneidet den aktuellen Block aus dem Text und speichert ihn in das Clipboard. 
Andere Programme, die das Clipboard ebenfalls unterstützen, können den Text 
somit mit ihrer Paste-Funktion hereinholen. Falls sich der Cursor innerhalb des 
Blocks befand, kommt er auf den ehemaligen Blockanfang. 

COPYBLK 

Kopiert den aktuellen Block in das Clipboard, ohne ihn zu löschen. 

PASTE SETBLOCK/S 

Fügt den Inhalt des Clipboards an der aktuellen Cursorposition ein. Der Cur¬ 
sor befindet sich anschließend hinter dem eingefügten Text. Falls SETBLOCK 
angegeben ist, wird der Block sofort um das gerade eingefügte Stück gelegt, so 
daß es sich sogleich horizontal verschieben oder wieder löschen läßt. 

DELETEBLK QUIET/S 

Entfernt den aktuellen Block, ohne ihn im Clipboard zu speichern. QUIET un¬ 
terdrückt die Nachfrage per Requester, ob der Block tatsächlich ohne Rück¬ 
holmöglichkeit gelöscht werden soll. Falls Cancel gewählt wird, ist der Rückga¬ 
becode 5. Falls sich der Cursor innerhalb des Blocks befand, kommt er auf den 
ehemaligen Blockanfang. 

UNMARKBLK 

Löscht die Blockmarkierung, d.h. die Marken S und E. 

SHIFTLEFT /N 

Verschiebt die Zeilen des Blocks um die angegebene Spaltenanzahl nach links. 
Wenn die Anzahl nicht angegeben ist, wird über einen Requester nachgefragt. 
Falls Cancel gewählt wird, ist der Rückgabecode 5. Der Block gilt hier zeilen¬ 
weise. Die Zeile mit Marke S gehört dazu, die Zeile mit Marke E aber nur, 
wenn E nicht auf Spalte 0 steht. Falls Zeilen nicht weit genug geschoben werden 
kann, weil Zeichen außer Leer- oder Tabulatorzeichen gelöscht würden, dann 
gibt es einen Fehler mit Rückgabecode 10, und die betroffenen Zeilen bleiben 
unverändert. 

SHIFTRIGHT /N 

Verschiebt die Zeilen des Blocks um die angegebene Spaltenanzahl nach rechts. 
Wenn die Anzahl nicht angegeben ist, wird über einen Requester nachgefragt. 
Falls Cancel gewählt wird, ist der Rückgabecode 5. Der Block gilt hier zeilen¬ 
weise. Die Zeile mit Marke S gehört dazu, die Zeile mit Marke E aber nur, wenn 
E nicht auf Spalte 0 steht. Falls Zeilen zu lang würden, dann gibt es einen Fehler 
mit Rückgabecode 10, und die betroffenen Zeilen bleiben unverändert. 

OPENCLIP FILENAME/F 
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Lädt eine Datei in das Clipboard. Wenn FILENAME nicht angegeben wird, 
erscheint der Filerequester. Falls Cancel gewählt wird, ist der Rückgabecode 5. 
Nach Laden der Datei kann deren Inhalt z.B. mit PASTE eingefügt werden. 

SAVEBLK FILENAME/F 

Schreibt den Block unter dem FILENAMEn in eine Datei. Wenn es keinen FI- 
LENAMEn gibt, wird er zuerst über den Filerequester abgefragt. Falls Cancel 
gewählt wird, ist der Rückgabecode 5. Im Gegensatz zu SAVEFILE wird hier 
kein Backup oder Icon erzeugt. 

UPPERCASE BLOCK 

Wandelt alle Zeichen im Block in Großbuchstaben. Siehe ARexx-Befehl UP¬ 
PERCASE. 

LOWERCASE BLOCK 

Wandelt alle Zeichen im Block in Kleinbuchstaben. Siehe ARexx-Befehl LO¬ 
WERCASE. 

SWAPCASE BLOCK 

Wandelt alle Zeichen im Block von Groß- und Kleinbuchstaben und umgekehrt. 
Siehe ARexx-Befehl SWAPCASE. 

C0NV2SPACES WIDTH/N 

Ersetzt alle Tabulatorzeichen im Block durch soviel Leerzeichen, daß jeweils die 
nächste Tabulatorposition unter der angegebenen Schrittweite WIDTH erreicht 
wird. Falls WIDTH nicht angegeben ist, wird die aktuelle Tabulatoreinstellung 
verwendet. Der Block gilt hier zeilenweise. Die Zeile mit Marke S gehört dazu, 
die Zeile mit Marke E aber nur, wenn E nicht auf Spalte 0 steht. Diese Funk¬ 
tion benötigen Sie für die Übertragung von Texten auf andere Editoren, die 
Tabulatorcodes nicht expandieren können, oder evtl, beim Ausdrucken, wenn 
der Drucker eine falsche Tabulatoreinstellung hat. 

C0NV2TABS WIDTH/N 

Ersetzt alle Leerzeichen im Block, die bis zu einer unter der angegebenen Schritt¬ 
weite WIDTH gültigen Tabulatorposition reichen, durch ein Tabulatorzeichen. 
F alls WIDTH nicht angegeben ist, wird die aktuelle Tabulatoreinstellung ver¬ 
wendet. Der Block gilt hier zeilenweise. Die Zeile mit Marke S gehört dazu, die 
Zeile mit Marke E aber nur, wenn E nicht auf Spalte 0 steht. Diese Funktion 
entspricht einem Komprimieren eines Textes. 

SELECTWORD 

Markiert das aktuelle Wort als Block. Ob das Wort als komplex angesehen wird, 
ist durch die Preference-Einstellung bestimmt. Falls der Cursor unmittelbar hin¬ 
ter dem Wort steht, wird dieses Wort trotzdem markiert. Ansonsten geschieht 
nichts. 

SELECTLINE 

Markiert die aktuelle Zeile als Block. 


SELECTALL 

Markiert den gesamten Text des Puffers als Block. 

GETBLKINFO 

Gibt ON zurück, falls der Block gelegt ist, sonst OFF. 

GETBLK 

Gibt den Text im Block zurück. Dazu muß der Block auf einer einzigen Zeile 
liegen und maximal 127 Zeichen lang sein. Falls das nicht erfüllt ist, gibt es einen 
Fehler. 


2.7.6 ARexx-Befehle zur Cursorbewegung 

G0T0LINE /N 

Springt auf eine Zeile mit der angegebenen Zeilennummer. Falls keine Zahl an¬ 
gegeben ist, wird sie über einen Requester abgefragt. Falls Cancel gewählt wird, 
ist der Rückgabecode 5. 

G0T0C0LUMN /N/A 

Springt auf eine Spalte. Auf den Befehl muß eine Spaltenzahl folgen. 

MOVE LINE/N/A, COLUMN/N/A 

Kombination von GOTOLINE und GOTOCOLUMN. 

GOTOLEFTMARGIN 

Springt auf den linken Rand. Der linke Rand kann durch SETPREFS eingestellt 
werden. 

GOTORIGHTMARGIN 

Springt auf den rechten Rand. Der rechte Rand kann durch SETPREFS einge¬ 
stellt werden. 

CURSOR UP/S, DOWN/S, LEFT/S, RIGHT/S 

Bewegt den Cursor eine Zeile hoch/runter oder eine Spalte nach links/rechts. 
Falls dieser Befehl durch Tastendruck ausgelöst wurde, ist es bei hoher Tasten¬ 
wiederholgeschwindigkeit möglich, daß um mehr als eine Zeile/Spalte bewegt 
wird. Falls bei UP bzw. DOWN bereits der Textanfang bzw. das Textende er¬ 
reicht wurde, ist der Rückgabecode 5. 

SCROLL UP/S, DOWN/S, LEFT/S, RIGHT/S 
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Bewegt den Cursor eine Zeile hoch/runter oder eine Spalte nach links/rechts, 
verschiebt aber den Text unter dem Cursor und läßt den Cursor auf derselben 
Bildschirmposition. Falls dieser Befehl durch Tastendruck ausgelöst wurde, ist 
es bei hoher Tastenwiederholgeschwindigkeit möglich, daß um mehr als eine 
Zeile/Spalte bewegt wird. 

POSITION SOF/S, EOF/S, SOV/S, EOV/S, SOL/S, EOL/S, SOW/S, EOW/S 
Bewegt den Cursor auf spezielle Position: 

• SOF ist Start-of-File, EOF ist End-of-File. 

• SOV ist Start-of-View, EOV ist End-of-View. 

• SOL ist Start-of-Line, EOL ist End-of-Line. 

• SOW ist Start-of-Word, EOW ist End-of-Word. 

Dabei ist SOF der Textanfang, EOF das Textende (eigentlich das erste Zeichen 
der letzten Zeile), SOV die oberste sichtbare Zeile, die noch nicht zum scrollsen- 
sitiven Bereich gehört, EOV entsprechend die unterste, SOL der Zeilenanfang, 
EOL das Zeilenende, SOW der Anfang des Wortes und EOW das Ende des 
Wortes. Die Positionen können auch kombiniert werden, z.B. bringt der Befehl 
»POSITION SOV SOL« den Cursor an den Anfang der obersten sichtbaren 
Zeile. 

NEXT WORD/S, PAGE/S 

Bewegt den Cursor zum nächsten Wort bzw. zur nächsten Seite. Zum nächsten 
Wort heißt ans Ende des aktuellen Wortes bzw. des folgenden, wenn der Cur¬ 
sor nicht auf einem Wort steht. Beim seitenweisen Blättern wird die unterste 
sichtbare Zeile der alten Seite zur obersten der neuen. Der Cursor bleibt dabei 
auf seiner visuellen Position innerhalb des Editierbereiches. Zum Springen auf 
den Anfang des nächsten Wortes siehe MOVENEXTWORD. An das Ende des 
Wortes zu gehen ist besonders für Fließtext im Wordwrap-Modus zu empfehlen. 

PREVIOUS WORD/S, PAGE/S 

Bewegt den Cursor zum vorigen Wort bzw. zur vorigen Seite. Zum vorigen Wort 
heißt auf den Anfang des aktuellen Wortes bzw. des davorstehenden, wenn der 
Cursor nicht auf einem Wort steht. Beim seitenweisen Blättern wird die oberste 
sichtbare Zeile der alten Seite zur untersten der neuen. Der Cursor bleibt dabei 
auf seiner visuellen Position innerhalb des Editierbereiches. 

MOVEDOWN LINES/N 

Bewegt den Cursor um die angegebene Zeilenanzahl nach unten. Wenn keine 
Zeilenanzahl angegeben ist, wird eine Zeile nach unten bewegt. 

MOVEUP LINES/N 

Bewegt den Cursor um die angegebene Zeilenanzahl nach oben. Wenn keine 
Zeilenanzahl angegeben ist, wird eine Zeile nach oben bewegt. 

MQVELEFT CHARS/N 

Bewegt den Cursor um die angegebene Zeichenanzahl nach links. Wenn keine 
Zeichenanzahl angegeben ist, wird um ein Zeichen nach links bewegt. 


MOVERIGHT CHARS/N 

Bewegt den Cursor um die angegebene Zeichenanzahl nach rechts. Wenn keine 
Zeichenanzahl angegeben ist, wird um ein Zeichen nach rechts bewegt. 

MOVEUPSCR 

Blättert eine Seite hoch wie »PREVIOUS PAGE«. 

MOVEDOWNSCR 

Blättert eine Seite runter wie »NEXT PAGE«. 

MOVESOF 

Bewegt den Cursor auf den Textanfang (Start-of-File). 

MOVEEOF 

Bewegt den Cursor auf das Textende (End-of-File). 

MOVESOL 

Bewegt den Cursor auf den Zeilenanfang (Start-of-Line). 

MOVEEOL 

Bewegt den Cursor auf das Zeilenende (End-of-Line). 

MOVENEXTWORD 

Geht an den Anfang des nächsten Wortes. »NEXT WORD« hingegen geht an 
das Ende des nächsten Wortes. 

MOVEPREVWORD 

Geht an den Anfang des vorigen Wortes wie »PREVIOUS WORD«. 

MOVENEXTTABSTOP 

Bewegt den Cursor auf die nächste Tabulatorposition. Die Tabulatorpositionen 
sind durch die Einstellung des Tabulatorabstandes per SETPREFS bestimmt. 

MOVEPREVTABSTOP 

Bewegt den Cursor auf die vorige Tabulatorposition. Die Tabulatorpositionen 
sind durch die Einstellung des Tabulatorabstandes per SETPREFS bestimmt. 


2.7.7 ARexx-Befehle zur Markenverwaltung 

OPENBOOKMARKS 

Öffnet das Markenfenster bzw. bringt es nach vorne, wenn es schon offen ist. 
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SETBOOKMARK NAME/F 

Setzt eine Marke mit dem NAMEn an die aktuelle Cursorposition. Der Nainc ist 
ein String. Falls er nickt angegeben wird, kommt ein Requester zur Namenab¬ 
frage, der als Vorschlag den aktuellen Block enthält (sofern er auf einer Zeile ist 
und maximal 127 Zeichen hat). Falls Cancel gewählt wird oder der Markenname 
oder NAME leer ist, ist der Rückgabecode 5. Führende Leer- und Tabulatorzei¬ 
chen im Markennamen werden ignoriert. Die Markennamen »S« und »E« sind 
für Blockstart und -ende reserviert, setzt man sie, wird dadurch automatisch der 
Block gelegt. 

CLEARBOOKMARK NAME/F 

Löscht eine Marke mit dem NAMEn. Falls der Name nicht angegeben wird, 
kommt ein Requester mit dem aktuellen Block als Vorschlag (sofern er auf einer 
Zeile ist und maximal 127 Zeichen hat). Falls Cancel gewählt wird oder der 
Markenname oder NAME leer ist, ist der Rückgabecode 5. Führende Leer- und 
Tabulatorzeichen im Markennamen werden ignoriert. 

G0T0B00KMARK NAME/F 

Springt eine Marke an. Falls kein NAME angegeben, kommt ein Requester mit 
dem aktuellen Block als Vorschlag (sofern er auf einer Zeile ist und maximal 
127 Zeichen hat). Falls Cancel gewählt wird oder der Markenname oder NAME 
leer ist, ist der Rückgabecode 5. Falls der Name mit dem Hashzeichen >#< 
beginnt, muß eine Dezimalzahl folgen, die als direkte Zeilennummer verstanden 
wird; diese Zeile wird dann angesprungen. Führende Leer- und Tabulatorzeichen 
im Markennamen werden ignoriert. 

MOVEBOOKMARK NAME/F 

Synonym für GOTOBOOKMARK aus Kompatibilitätsgründen. 


2.7.8 ARexx-Befehle zur Fensterverwaltung 

ACTIVATEDOC 

Bringt das Fenster des mit diesem ARexx-Befehl angesprochenen Puffers in den 
Vordergrund und aktiviert es. 

ACTIVATELASTDOC 

Aktiviert das Fenster des aktuellen Puffers, bringt es in den Vordergrund und 
bringt auch den Screen des Editors in den Vordergrund. Falls es keinen aktuellen 
Puffer gibt, wird das letzte Editorfenster aktiviert. 


Aktiviert den im Pufferlistenfenster auf den aktuellen Puffer folgenden Puffer 
und bringt sein Fenster und den Editor-Screen nach vorne. Nach dem letzten 
Puffer wird wieder der erste aktiviert. 

ACTIVATEPREVDOC 

Aktiviert den im Pufferlistenfenster vor dem aktuellen Puffer stehenden Puffer 
und bringt sein Fenster und den Editor-Screen nach vorne. Nach dem ersten 
Puffer wird wieder der letzte aktiviert. 

ACTIVATEWINDOW 

Aktiviert das letzte aktive Editorfenster. Dies kann auch ein Hilfsfenster sein. 

SPLITVIEW 

Teilt den aktuellen Editierbereich in zwei Hälften auf. Es entstehen zwei Edi¬ 
tierbereiche mit gleicher Positionierung im Text. Der obere wird zum aktuellen 
Editierbereich. Falls im Fenster kein Platz für einen zusätzlichen Editierbereich 
ist, passiert nichts. 

DELETEVIEW 

Löscht den aktuellen Editierbereich und schaltet auf den darunter liegenden 
bzw. den darüber, wenn der unterste gelöscht wird. Falls das Fenster nur einen 
Editierbereich hat, passiert nichts. 

NEXTVIEW 

Aktiviert den unter dem aktuellen Editierbereich stehenden Editier bereich. Gibt 
es dort keinen weiteren, wird der oberste Editierbereich aktiviert. 

PREVVIEW 

Aktiviert den über dem aktuellen Editierbereich stehenden Editierbereich. Gibt 
es dort keinen weiteren, wird der unterste Editierbereich aktiviert. 

GROWVIEW 

Vergrößert den aktuellen Editierbereich um eine Textzeile, falls das möglich ist. 

SHRINKVIEW 

Verkleinert den aktuellen Editierbereich um eine Textzeile, falls das möglich ist. 

BEEPSCREEN 

Läßt den Screen, auf dem der Editor läuft, kurz aufblinken. 

CHANGEWINDOW NAME/K, XPOS/N/A, YPOS/N/A, WIDTH/N/A, HEIGHT/N/A 

Bewegt das aktuelle Fenster auf die Position (XPOS,YPOS) und skaliert es auf 
die Größe (WIDTH,HEIGHT). Wenn einer der Werte gleich -1 ist, bleibt er 
unverändert (Achtung: ARexx versteht die -1 nur, wenn sie als ’-l’ angege¬ 
ben ist). Da Fenster keine Teile außerhalb der Screengrenzen haben können, ist, 
es möglich, daß das Ergebnis nicht ganz mit den gewünschten Werten überein¬ 
stimmt, denn der Editor verschiebt das Fenster bzw. skaliert es so, daß es auf den 
Screen paßt. NAME kann »FIND«, »BUFFERLIST« oder »BOOKMARKS« 


ACTIVATENEXTDOC 
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sein und bestimmt dann, daß dieses Fenster in seiner Größe und Position 
geändert wird. Falls das Fenster in dem Moment nicht offen ist, wird es sich beim 
nächsten Mal mit diesen Werten öffnen (siehe auch SAVEWINDOWINFO). 
Wenn NAME fehlt, wird das aktuelle Fenster betroffen. 

SAVEWINDOWINFO NAME/F 

Schreibt ein ARexx-Programm in die Datei NAME, das Information darüber 
enthält, wie beim nächsten Startup die Hilfsfenster zu öffnen sind. Falls NAME 
nicht angegeben ist, wird er über einen Requester abgefragt. Beispiel: 

/* Startup Windowinfo */ 

CHANGEWINDOW FIND 10 10 ’-l’ »-1» 

OPENFIND 

CHANGEWINDOW NAME BOOKMARKS 20 100 200 400 
0PENB00KMARKS 

Diese Datei kann z.B. beim Shell-Start, als gleich abzuarbeitendes ARexx- 
Programm angegeben werden, so daß der Editor die Hilfsfenster genau dort 
öffnet, wo sie beim letzten Aufruf von SAVEWINDOWINFO standen. Eine an¬ 
dere Möglichkeit ist es, die Datei als Standard-Startup-Makro HiTex.hit abzu¬ 
speichern. 

WIND0W2FR0NT 

Bringt das Textfenster in den Vordergrund und aktiviert es. 

WIND0W2BACK 

Bringt das Textfenster in den Hintergrund. 

SCREEN2FR0NT 

Bringt den Screen, auf dem der Editor läuft, in den Vordergrund. 

SCREEN2BACK 

Bringt den Screen, auf dem der Editor läuft, in den Hintergrund. 

WB2FR0NT 

Bringt den Workbench-Screen in den Vordergrund. 


2.7.9 ARexx-Befehle für die Preferences 

0PENPREFWIND0W 

Öffnet den Preference-Requester. Alle anderen Fenster werden blockiert. 
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0PENSCREENPREFWIND0W 

Öffnet den Screen-Preference Requester. Alle anderen Fenster werden blockiert. 
OPENPREFS FILENAME/F 

Lädt eine Preferencedatei. Wenn FILENAME nicht angegeben wird, erscheint 
der Filerequester. Falls Cancel gewählt wird oder der Dateiname leer ist, ist der 
Rückgabecode 5. FILENAME sollte die komplette Pfadangabe enthalten. 

SAVEPREFS FILENAME/F 

Speichert eine Preferencedatei. Wenn FILENAME nicht angegeben wird, er¬ 
scheint der Filerequester. Falls Cancel gewählt wird oder der Dateiname leer ist, 
ist der Rückgabecode 5. FILENAME sollte die komplette Pfadangabe enthalten. 

SETPREFS PREFS/A, SETTING/F 

Stellt einen Preferencewert PREFS auf die Einstellung SETTING. Siehe auch 
Kapitel über die Preferences. Als PREFS und SETTING sind die folgenden 
Möglichkeiten vorhanden: 

ASLRequest [ 0N | OFF | T0GGLE ] 

AutoSOLTabs [ 0N | OFF I T0GGLE ] 

BackupMode [ OFF | T | BAK ] 

ComplexWords [ 0N | OFF | T0GGLE ] 

ConsoleName <Consolename> 

DefaultName <Defaultname> 

FilePattem <Filepattem> 

HideMouse [ 0N | OFF i T0GGLE ] 

LeftMargin <LinkerRand> 

OpenSize <Width> <Height> 

Overstrike [ 0N | OFF I T0GGLE ] 

Refresh [ SIMPLE I SMART ] 

RightMargin <RechterRand> 

Saveicons [ 0N | OFF | T0GGLE ] 

TabExpand [ 0N I OFF | T0GGLE ] 

TabWidth <Tabulatorabstand> 

WordWrap [ 0N | OFF | T0GGLE ] 

WrapAround [ 0N I OFF I T0GGLE ] 

GETPREFS PREFS/A 

Gibt den aktuellen Preferencewert für PREFS zurück. PREFS kann die gleichen 
Werte wie bei SETPREFS annehmen. 

FETCHOPENSIZE 

Holt die Größe des aktuellen Textfensters und setzt die »OpenSizec-Einstellung 
der Preferences auf diesen Wert. Falls es kein aktuelles Textfenster gibt, bleibt 
»OpenSize< unverändert. 
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2.7.10 ARexx-Steuerbefehle und Makros 

EXECAREXXSTRING SYNC/S, ASYNC/S, MAIN/S, CONSOLE/S, MACRO/F 

Führt den String MACRO als ARexx-Programm aus. Falls MACRO nicht ange¬ 
geben ist, kommt ein Requester hoch und fragt nach dem auszuführenden String. 
Falls Cancel gewählt wird oder der Name leer ist, ist der Rückgabecode 5. Mit 
SYNC kehrt der Befehl erst nach vollständiger Ausführung des Makros zurück, 
mit ASYNC können die Befehle beliebig eingestreut eintreffen. Sind beide nicht 
angegeben, wird synchron gearbeitet. MAIN bestimmt, ob der Default-Host für 
die Ausführung der ARexx-Hauptport oder der lokale Port des aktuellen Puf¬ 
fers ist (siehe auch ARexx-Handbuch). Mit CONSOLE wird für die Dauer der 
Ausführung ein Consolefenster geöfFnet, dessen Dateiname durch den Console- 
Namen in den Preferences bestimmt ist (siehe auch Kapitel 2.9). Der eingegebene 
Befehl wird von Aufruf zu Aufruf gemerkt und als Vorschlag beim Offnen des 
Requesters wie beim Workbench-Befehl »Execute command« angegeben. 

RXS SYNC/S, ASYNC/S, MAIN/S, CONSOLE/S, MACRO/F 

Synonym für EXECAREXXSTRING. 

EXECAREXXMACRO SYNC/S, ASYNC/S, MAIN/S, CONSOLE/S, MACRO/F 

Führt ein ARexx-Prograinm namens MACRO aus. Falls MACRO nicht ange¬ 
geben ist, erscheint der Filerequester und fragt nach dem auszuführenden Pro¬ 
gramm. Falls Cancel gewählt wird oder der Dateiname leer ist, ist der Rückgabe¬ 
code 5. Mit S YNC kehrt der Befehl erst nach vollständiger Ausführung des Pro¬ 
grammes zurück, mit ASYNC können die Befehle beliebig eingestreut eintreffen. 
Sind beide nicht angegeben, wird synchron gearbeitet. MAIN bestimmt, ob der 
Default-Host für die Ausführung der ARexx-Hauptport oder der lokale Port des 
aktuellen Puffers ist (siehe auch ARexx-Handbuch). Mit CONSOLE wird für die 
Dauer der Ausführung ein Consolefenster geöffnet, dessen Dateiname durch den 
Console-Namen in den Preferences bestimmt ist (siehe auch Kapitel 2.9). ACH¬ 
TUNG: Der komplette Pfadname des Programmes einschließlich Volume-Namen 
darf keine Leerzeichen enthalten, sonst findet ARexx das Programm nicht und 
meldet Fehler 1. Um z.B. ARexx-Programme aus der Ram-Disk zu starten, sollte 
Ihr Volumename gegebenenfalls so umbenannt werden, daß er keine Leerzeichen 
enthält. 

RX SYNC/S, ASYNC/S, MAIN/S, CONSOLE/S, MACRO/F 
Synonym für EXECAREXXMACRO. 

RECORDMACRO 

Startet die Makroaufnahme. Alle Menübefehle, Tastenbefehl und ARexx-Befehle 
(außer RECORDMACRO, ENDMACRO, PLAYMACRO und SAVEMACRO) 
werden ab jetzt aufgezeichnet. Für die Dauer der Makroaufnahme ändert sich 
der Mauszeiger in ein Kassettensymbol. 

ENDMACRO 

Beendet die Makroaufnahme. Der aufgenommene Makro kann nun per PLAY¬ 
MACRO abgespielt werden. Falls keine Makroaufnahme läuft, passiert nichts. 


PLAYMACRO COUNT/N 

Führt den aufgenommenen Makro aus. Wenn COUNT fehlt, wird die Anzahl der 
Makroausführungen per Requester abgefragt. Wenn COUNT Null ist, wird der 
Makro immer wieder ausgeführt, bis ein Fehler auftritt. Sonst wird der Makro 
so oft ausgeführt, wie COUNT angibt. 

SAVEMACRO FILENAME/F 

Speichert den aufgezeichneten Makro als ARexx-Programm in eine Datei. Wenn 
FILENAME nicht angegeben wird, erscheint der Filerequester. Falls Cancel 
gewählt wird oder der Dateiname leer ist, ist der Rückgabecode 5. FILENAME 
sollte die komplette Pfadangabe enthalten. 

DEFINEKEY KEY/A, SHIFT/S, ALT/S, CONTROL/S, LAMIGA/S, COMMAND/A/F 

Uberlädt eine Taste dynamisch wie auch bei der Setup-Datei möglich. KEY 
muß ein ASCII-Zeichen oder ein mnemonischer Name wie in der Setup-Datei 
sein (RETURN etc.). Es sind dieselben Qualifier wie in der Setup-Datei erlaubt. 
Beispiel: Auf die Fl-Taste hin soll ein ARexx-Makro ausgeführt werden: 

DefineKey Fl ’RX RAM:ARexxMakro’ 

REQUESTNOTIFY TITLE/A, PROMPT/A 

Öffnet einen Requester mit »Ok«-Gadget, TITLE als Titelstring und PROMPT 
als inneren Text. 

REQUESTBOOL TITLE/A, PROMPT/A 

Öffnet einen Requester mit »Ok« und »Cancel<-Gadget, TITLE als Titel¬ 
string und PROMPT als inneren Text und liefert YES oder NO an ARexx 
zurück. 

REQUESTNUM TITLE/A 

Öffnet einen Requester zur Zahleneingabe. Die Zahl kommt als String an ARexx 
zurück. Falls Cancel gedrückt wird, ist der Rückgabecode 5. 

REQUESTSTR TITLE/K, DEFAULT/F 

Öffnet einen Requester zur Stringeingabe. TITLE kann den Titel des Requesters 
angeben, DEFAL T LT den Initialstring. Das Ergebnis wird als String an ARexx 
zurückgegeben. Falls Cancel gedrückt wird, ist der Rückgabecode 5. 

REQUESTFILE TITLE/K, PATTERN/K, PATH/F 

Öffnet den Filerequester mit dem Titel TITLE, dem Filepattern PATTERN 
und dem Verzeichnis PATH. PATH muß existieren, wenn es angegeben ist. Der 
vollständige Dateiname wird als String an ARexx zurückgegeben. Falls Cancel 
gedrückt wird, ist der Rückgabecode 5. Falls die Datei noch nicht auf Platte exi¬ 
stiert, kann der Name falsch sein, sofern der Dateiname noch Verzeichnisangaben 
enthält. 

WRITECHARCODE 
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Schreibt den Zeichencode des Zeichens unter dem Cursor als Dezimal- und He¬ 
xadezimalzahl auf die Statuszeile. 

WRITESTRING STRING/F/A 

Schreibt den STRING in die Statuszeile. 

SETPRIORITY /N/A 

Setzt die Task-Priorität des Editors auf den angegebenen Wert. Vorsicht: Zu 
hohe Werte können üble Dinge für das System bedeuten! 

GETPRIORITY 

Holt die Task-Priorität des Editors. 


2.7.11 ARexx-Befehle zum Suchen/Ersetzen 

OPENFIND 

Öffnet das Suchfenster und aktiviert das Find-Gadget. 

FIND FORWARD/S, BACKWARD/S, CASEON/S, CASEOFF/S, W0RD0N/S, W0RD0FF/S, 

FROMBLOCK/S, UNTIL/K, TEXT/F 

Sucht nach dem angegebenen String. Falls der Suchstring fehlt, wird der aktuell 
eingestellte genommen. Wenn die Schalter nicht angegeben werden, verwendet 
der Editor die aktuellen Einstellungen. FROMBLOCK holt den Suchstring aus 
dem aktuellen Block. Nach UNTIL muß ein Markenname folgen. Von der aktu¬ 
ellen Position aus wird gesucht, bis die Marke erreicht ist. Wenn die Marke vor 
der aktuellen Position liegt und vorwärts gesucht wird, findet der Editor nichts 
und bricht sofort ab. Nach der Ausführung sind die obigen Einstellungen in das 
Findfenster übernommen. Anmerkung: Das UNTIL-Feature ist vorerst nicht im¬ 
plementiert. Wenn der String nicht gefunden wird, ist der Rückgabecode 5. 

FINDCHANGE FORWARD/S, BACKWARD/S, CASEON/S, CASEOFF/S, W0RD0N/S, 

W0RD0FF/S, FROMBLOCK/S, ALL/S, UNTIL/K, PROMPT/S, FIND/K, CHANGE/K 

Sucht nach einem Text und ändert ihn. PROMPT bringt vor dem Austausch 
einen Frage-Requester hoch. FIND gibt den Suchtext an, CHANGE den Ersetz¬ 
text. Mit ALL wird nach dem Austausch gleich weitergesucht. Wenn kein Such¬ 
oder Ersetzstring angegeben wird, benutzt der Editor die aktuell eingestellten 
Strings. Nach UNTIL muß ein Markenname folgen. Von der aktuellen Position 
aus wird gesucht, bis die Marke erreicht ist. Wenn die Marke vor der aktuel¬ 
len Position liegt und vorwärts gesucht wird, findet der Editor nichts und bricht 
sofort ab. Nach der Ausführung sind die obigen Einstellungen übernommen. An¬ 
merkung: Das UNTIL-Feature ist vorerst nicht implementiert. Wenn der String 
nicht gefunden wird, ist der Rückgabecode 5. 
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MOVEMATCHBKT 

Findet die Klammer, die zu der unter dem Cursor stehenden paßt, und posi¬ 
tioniert den Cursor auf ihr. Ist das Zeichen unter dem Cursor keine Klammer, 
ist der Rückgabecode 5. Existiert keine passende Klammer, dann gibt es einen 
Fehler. Als Klammern gelten: 

()[]{}<> 

Diese Funktion wird auch durch Doppelklick auf eine der oberen Klammern 
ausgelöst. 


2.7.12 ARexx-Befehle zur Statusinformation 

COPYRIGHT 

Öffnet einen Requester mit der Copyright-Meldung und der Angabe des noch 
freien Speichers. Hier ist auch der ARexx-Hauptportname verzeichnet. 

GETVERSION 

Gibt für ARexx die Versionsnummer des Editors zurück. 

HELP COMMAND/A/F 

Liefert zu einem Befehl die passende Parameter-Schablone zurück. Falls der 
Befehl nicht existiert, ist der Rückgabecode 5. 

GETCHAR 

Gibt das Zeichen unter dem Cursor zurück. 

GETWORD 

Gibt das Wort unter dem Cursor zurück. Ob W 7 orte komplex sind, ist durch die 
Preferences bestimmt. Falls der Cursor unmittelbar hinter einem Wort steht, 
wird dieses trotzdem zurückgegeben. 

GETLINE /N 

Gibt den Inhalt einer Zeile zurück. Wenn die Zeilennummer nicht angegeben 
ist, wird die aktuelle Zeile zurückgegeben. Falls die Zeile nicht existiert, ist der 
Rückgabestring leer und der Rückgabecode 5. 

GETCURS0RP0S 

Gibt einen String der Form »z s« zurück, wobei »z« die Zeilennummer und 
»s« die Spaltennummer ist. 

GETDOCUMENTS 
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Gibt einen String mit den ARexx-Portnamen der derzeit existierenden Puffer 
zurück. 

GETPORT MAIN/S FILENAME/F 

Holt den ARexx-Portnamen der angegebenen Datei. Falls FILENAME und 
MAIN fehlen, wird der Portname des aktuellen Puffers geholt. Der FILE¬ 
NAME muß mit dem im Fenstertitel erscheinenden Namen einschließlich Groß- 
/Kleinschreibung identisch sein. Ist MAIN angegeben, dann wird der Name des 
ARexx-Hauptports zurückgegeben und FILENAME ignoriert. 

GETFILEINFO 

Gibt Information für den Puffer zurück. Das Ergebnis hat die Form »Zeilen 
mod Name«, dabei ist »zeilen« die Anzahl der Zeilen, »mod« ist »YES« oder 
»NO« und zeigt an, ob der Puffer verändert wurde, und »Name« ist der im 
Fenstertitel sichtbare Name des Puffers. 

GETFILEPATH 

Gibt den kompletten Pfadnamen des Puffers zurück. Falls der Puffer noch nicht 
als Datei auf Platte existiert, kann dieser Name falsch sein, sofern der Fenstertitel 
noch Verzeichnisangaben enthält. 

GETSCREENINFO 

Gibt Information über den aktuellen Screen zurück, auf dem der Editor gerade 
seine Fenster geöffnet hat. Das Ergebnis hat die Form »left top width height 
depth xclip yclip«. Die Werte sind die Position, die Größe und Tiefe des Screens. 
Die Clipwerte geben die sichtbare Größe des Screens an und sind bei scrollbaren 
Screens von den vorderen Größenangaben verschieden. 

GETWINDOWINFO 

Gibt Information über das aktuelle Textpufferfenster zurück. Das Ergebnis hat 
die Form »hidden x y width height minwidth minheight, numviews«. Dabei ist 
»hidden« gleich »OFF« bzw. »ON«, wenn das Textfenster über den Befehl 
HIDEFILE unsichtbar gemacht wurde. Die nächsten vier Werte geben die Po¬ 
sition und Größe des Fensters an und die nächsten beiden die minimale Größe 
des Fensters, »numviews« sagt aus, wieviele Editierbereiche derzeit existieren. 

GETVIEWINFO 

Gibt Information über den aktuellen Editierbereich zurück. Das Ergebnis hat 
die Form »view lines chars topline leftchar«. »view« ist die Nummer des Edi¬ 
tierbereiches, »lines« die sichtbare Zeilenanzahl, »chars« die sichtbare Zeichen¬ 
anzahl, »topline« die Zeilennummer der obersten sichtbaren Zeile des Editier¬ 
bereiches und »leftchar« die linke, sichtbare Spalte. 
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2.7.13 ARexx-Befehle zur Textänderung 

TEXT TEXT/F 

Fügt den angegebenen Text an der aktuellen Position ein. Dabei werden Over- 
strike und Wordwrap berücksichtigt. 

INSERT TEXT/F 

Synonym zu TEXT. 

FORMATPARAGRAPH 

Formatiert einen Absatz wie im Wordwrap-Modus, ohne Zeichen einzufügen 
oder zu entfernen. 

TABINDENT BACK/S 

Rückt den Text der aktuellen Zeile nach rechts, und zwar auf die nächste Po¬ 
sition, an der in der darüberstehenden Zeile das nächste Wort beginnt, wobei 
hier Worte nur durch Leerzeichen und Tabulatorzeichen getrennt werden, d.h., 
die Preference-Einstellung »Complex Words« gilt hier nicht. Das Einrücken ge¬ 
schieht durch Einfügen von Leerzeichen (der Overstrike-Modus hat hier keine 
Auswirkung). Gibt es den Wortanfang oder die vorige Zeile nicht, dann wird 
zur nächsten Tabulatorposition eingerückt. Mit BACK wird rückwärts gearbei¬ 
tet, was allerdings beim Löschen von Tabulatorzeichen zu falschen Ergebnissen 
führen kann (dies ist von Hand zu korrigieren). Es werden nur soviel Leer- und 
Tabulatorzeichen gelöscht wie möglich, übrige Zeichen bleiben erhalten. 

NEWLINE 

Spaltet die Zeile an der aktuellen Cursorposition und bewegt den Zeilenrest in 
eine neu erzeugte Zeile. Der Zeilenrest beginnt auf der neuen Zeile erst am linken 
Rand. 

NEWLINEINDENT 

Wie NEWLINE, aber statt am linken Rand wird in der neuen Zeile auf derselben 
Position begonnen, an der sich in der alten das erste Zeichen befindet, das weder 
ein Leer- noch ein Tabulatorzeichen ist. 

APPENDLINE 

Bewegt den Cursor ans Zeilenende und hängt die nächste Zeile an die aktuelle 
an. Gibt es keine Nachfolgerzeile, ist der Rückgabecode 5. 

DELETELINE 

Löscht die aktuelle Zeile und geht auf die Folgezeile. Gibt es diese nicht, wird 
die aktuelle nur geleert, nicht entfernt, und der Rückgabecode ist 5. Der alte 
Zeileninhalt kann mit UNDELETELINE zurückgeholt werden. 

UNDELETELINE 


Holt den Inhalt des letzten DELETELINE zurück. Dabei wird unabhängig von 
der Cursorposition immer die komplette Zeile vor der aktuellen eingefügt. 
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DELETE CHARS/N 

Löscht soviele Zeichen wie angegeben unter dem Cursor, ohne ihn zu bewegen. 
Keine Angabe löscht ein Zeichen. Wenn WrapAround durch SETPREFS ein¬ 
geschaltet ist, führt DELETE am Zeilenende zu APPENDLINE. CHARS kann 
maximal 254 sein. 

BACKSPACE 

Löscht das Zeichen vor (links von) dem Cursor und bewegt ihn nach links. Wenn 
der Cursor auf Spalte 0 stand, wird die aktuelle Zeile an die vorige per APPEND¬ 
LINE angehängt. 

UNDOLINE 

Stellt den Zeileninhalt wieder so her, wie er beim Anwählen der Zeile war. Im 
Wordwrap-Modus kann dies wegen der ständig stattfindenden Formatierung zu 
unerwarteten Ergebnissen führen. 

SETCHAR CHAR/A 

Setze das Zeichen unter dem Cursor auf CHAR. Hat CHAR mehrere Zeichen, 
dann wird nur das erste genommen. 

EXCHANGECHARS 

Vertauscht das Zeichen unter dem Cursor mit dem hinter (rechts von) ihm. 
SWAPCHARS 

Vertauscht das Zeichen unter dem Cursor mit dem vor (links von) ihm. 
TOGGLECHARCASE 

Wandelt das Zeichen unter dem Cursor von Groß- nach Kleinschreibung bzw. 
umgekehrt und geht einen Schritt nach rechts. 

INSERTASCII STRING/F 

Fügt ein ASCII-Zeichen per Code-Angabe in den Text ein. STRING muß eine 
Dezimalzahl oder Hexadezimalzahl im Bereich 0 bis 255 sein. Falls STRING 
nicht angegeben ist, wird auf den interaktiven Modus geschaltet, in dem so 
lange per Requester Zeichen eingefügt werden, bis ein leerer String als Eingabe 
kommt oder Cancel angeklickt wird. 

INSERTSPACE 

Fügt ein Leerzeichen an der aktuellen Cursorposition ein, auch wenn der 
Overstrike-Modus eingeschaltet ist. 

DELETESOL 

Löscht alle Zeichen vom Zeilenbeginn bis zum Cursor. Das Zeichen unter dem 
Cursor bleibt unberührt. SOL heißt Zeilenanfang (Start-of-line). Der Cursor 
steht nach diesem Befehl auf dem Zeilenanfang. 


Löscht alle Zeichen unter bzw. hinter dem Cursor bis zum Zeilenende. EOL heißt 
Zeilenende (End-of-line). 

CLEARSOL 

Setzt alle Zeichen vom Zeilenbeginn bis zum Cursor auf Leerzeichen. Wenn in 
den Preferences »Aut.oSOLTab« eingeschaltet ist, dann werden entsprechend 
auch Tabulatorzeichen gesetzt. Das Zeichen unter dem Cursor bleibt unberührt. 

DELETESOW 

Wenn Cursor auf einem Wort steht, werden alle Zeichen vor dem Cursor bis zum 
Wortanfang gelöscht, sonst alle Zeichen bis zum Ende des vorigen Wortes. 

DELETEEOW 

Wenn Cursor auf einem Wort steht, werden alle Zeichen vom Cursor an bis zum 
Wortende gelöscht, sonst alle Zeichen bis zum Anfang des nächsten Wortes. 

REPLACEWORD WORD/F/A 

Ersetzt das Wort unter dem Cursor durch das angegebene Wort. Falls der Cursor 
auf keinem Wort steht, wird das Wort eingefügt. 

UPPERCASE CHAR/S, WORD/S, LINE/S, BLOCK/S 

Ändert alle Zeichen des angegebenen Bereiches auf Großbuchstaben. Der Editor 
wandelt auch deutsche bzw. anderssprachige Sonderzeichen um. So wird z.B. 
aus »ö< ein »O« oder aus >ae« ein »2E« etc. 

LOWERCASE CHAR/S, WORD/S, LINE/S, BLOCK/S 

Ändert alle Zeichen des angegebenen Bereiches auf Kleinbuchstaben. Der Editor 
wandelt auch deutsche bzw. anderssprachige Sonderzeichen um. So wird z.B. aus 
»O« ein »ö< oder aus »/E« ein »ae« etc. 

SWAPCASE CHAR/S, WORD/S, LINE/S, BLOCK/S 

Ändert alle Zeichen des angegebenen Bereiches von Groß- auf Kleinbuchstaben 
bzw. umgekehrt. Der Editor wandelt auch deutsche bzw. anderssprachige Son¬ 
derzeichen um. So wird z.B. aus »ö< ein »O« oder aus »JE< ein »ae< etc. 

C0NV2UPPER 

Ändert, den markierten Block (bzw. das aktuelle Wort, wenn kein Block markiert 
ist) auf Großschreibung. 

C0NV2L0WER 

Ändert den markierten Block (bzw. das aktuelle Wort, wenn kein Block markiert 
ist) auf Kleinschreibung. 


DELETEEOL 
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2.7.14 ARexx-Befehle für Assembler und Fehlerliste 

OPENASSEMBLE 

Öffnet, den Assemble-Requester. Der aktuelle Puffer kann nachher assembliert 
werden. Im Object-Gadget kann der Name der zu erzeugenden Objektdatei an¬ 
gegeben werden, und im Options-Gadget können die Assembler-Optionen ange¬ 
geben werden, die nicht durch die Checkboxen erreichbar sind. Die Einstellungen 
des Assemble-Requesters werden in der Preferencedatei abgespeichert. 

ASSEMBLE 

Assembliert einen Puffer mit den aktuellen Einstellungen des Assemble- 
Requesters. Wenn der Befehl über den Hauptport kam, wird der aktuelle Puffer 
assembliert, sonst der angesprochene. Die Assemblierung startet sofort, ohne den 
Assemble-Requester aufzurufen. Ich empfehle, statt OPENASSEMBLE und AS¬ 
SEMBLE das Make-Utility zu benutzen. Dann wird der Assembler nur durch 
einen Tastendruck gestartet, und es stehen all die mächtigen Möglichkeiten von 
MAKE zur Verfügung. 

RUNPROGRAM 

Läßt das vom Assembler in den Speicher assemblierte Programm ablaufen. Falls 
Ihr Programm abstürzt, hängt sich aber auch der Editor auf! 

LOADASSEMBLER FILENAME/F 

Lädt den Optimierenden Makro-Assembler resident. Falls der Assembler bereits 
resident ist oder die zu ladende Datei nicht der OMA ist, gibt es eine Fehler¬ 
meldung. Falls FILENAME nicht angegeben ist, erscheint der Filerequester zur 
Auswahl. Falls Cancel gewählt wird oder der Name leer ist, ist der Rückgabe¬ 
code 5. Der angegebene Name wird als Assembler-Defaultname in die Preferences 
übernommen. 

UNLOADASSEMBLER 

Entfernt den residenten Assembler, die Fehlerliste und das vom Assembler in 
den Speicher assemblierte Programm. 

FIRSTERROR 

Wählt den ersten Fehler der Fehlerliste an. Wenn kein Eintrag in der Fehlerliste 
existiert, dann gibt es einen Fehler mit Rückgabecode 20. 

NEXTERROR 

Wählt den nächsten Fehler der Fehlerliste an. Wenn kein nächster Eintrag exi¬ 
stiert, gibt es einen Fehler mit Rückgabecode 10. Wenn keine Fehlerliste existiert, 
gibt es einen Fehler mit Rückgabecode 20. 

PREVERROR 

Wählt den vorigen Fehler der Fehlerliste an. Wenn kein nächster Eintrag exi¬ 
stiert, gibt es einen Fehler mit Rückgabecode 10. Wenn keine Fehlerliste existiert, 
gibt es einen Fehler mit Rückgabecode 20. 
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CURRENTERROR 

Wählt den aktuellen Fehler der Fehlerliste an. Wenn kein nächster Eintrag exi¬ 
stiert, gibt es einen Fehler mit Rückgabecode 10. Wenn keine Fehlerliste existiert, 
gibt es einen Fehler mit Rückgabecode 20. 

READERRORLIST FILENAME/F 

Lädt eine Datei mit Fehlerlisten-Inhalt. Damit können Fehler eines Compilers 
bzgl. eines Puffers bequem über NEXTERROR angesprungen werden. Vorteil: 
Beim Einfügen von Zeilen u.ä. wird die Fehlerstelle immer korrekt mitgeführt. 
Falls FILENAME nicht angegeben ist, erscheint der Filerequester zur Auswahl. 
Falls Cancel gewählt wird oder der Name leer ist, ist der Rückgabecode 5. Das 
Format der Fehlerlistendatei ist: 

; Dies ist ein Kommentar, 
zeile spalte Fehlertext 

»Zeile« ist die Zeilennummer, »Spalte« die Zeichenposition innerhalb der Zeile, 
wobei das erste Zeichen Position 0 hat und Tabulatoren als ein Zeichen zählen. 
Wenn »Fehlertext« Leerzeichen u.ä. enthalten soll, muß er in Hochkommata 
eingefaßt werden. Der Backslash ist das Fluchtsymbol. Es sind zwar beliebig 
viele Fehler möglich, aus Performancegründen sollte deren Anzahl aber nicht zu 
groß werden. Die Fehlerliste gehört zu dem Puffer, an dessen Port der Befehl 
geschickt wurde (Hauptport bedeutet aktueller Puffer). Siehe auch Kapitel 2.8 
über das Make-Utility. 

CLEARERRORLIST 

Löscht die Fehlerliste und das vom Assembler in den Speicher assemblierte 
Programm. Dies ist nützlich, wenn sie sehr lang ist und bei Pufferänderungen 
Performance-Einbußen verursacht. 
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2.8 Das Make-Utility 

2.8.1 Beschreibung 

Der Befehl MAKE startet das integrierte Make-Utility. MAKE ermöglicht die einfa¬ 
che Behandlung von großen Softwarepaketen, indem nach einmaliger Erzeugung eines 
Makefiles und damit der Angabe der Abhängigkeiten der Module nur MAKE aufgeru¬ 
fen werden muß. Dann werden alle nötigen Aktionen ausgeführt, um zu der neuesten, 
gültigen Programmversion zu gelangen. Im Makefile sind die Abhängigkeiten zeilenweise 
angegeben. Es hat die folgende Syntax: 

• Eine Leerzeile wird ignoriert. 

• Kommentarzeilen beginnen mit einem Hash-Zeichen >#< oder Semikolon >;< 
als erstem Zeichen und enden mit dem Zeilenende. Ein Kommentar darf ferner 
in jeder Zeile enthalten sein, wenn er wie bei einer Shell mit einem Semikolon 
beginnt; davor muß jedoch mindestens ein Leer- oder Tabulatorzeichen stehen. 
Der Kommentar ist bis zum Zeilenende gültig. 

• Eine oder mehrere Abhängigkeitszeilen gehen einer Reihe von Kommandozeilen 
voraus. Die Kommandozeilen beginnen mit einem Leer- oder Tabulatorzeichen 
und werden wie von einer Shell ausgeführt, wenn mindestens eine der Abhängig¬ 
keitszeilen das Resultat TRUE liefert. Vor der Ausführung einer Kommandozeile 
gibt MAKE die Kommandozeile mit dem Vorsatz »Make: < aus, so daß die 
Aktionsfolge dokumentiert wird. 

• Abhängigkeitszeilen haben die folgende Syntax: 

HAUPTDATEI: DATEI1 DATE12 DATEI3 etc. 

Die Dateinamen werden durch Leer- oder Tabulatorzeichen getrennt; der erste 
Dateiname muß mit einem Doppelpunkt enden und auf dem ersten Zeichen der 
Zeile beginnen. Das Resultat der Zeile ist TRUE, wenn die Hauptdatei nicht exi¬ 
stiert oder eine der darauf folgenden Dateien (diese heißen Abhängigkeitsdateien) 
ein jüngeres Datum als die Hauptdatei hat. Wichtige Voraussetzung dazu ist, daß 
die Systemuhr richtig gesetzt ist. Nehmen Sie einen Hauptdateinamen, der nicht 
existiert (evtl, sinnvoller weise true:), so ist das Ergebnis der Abhängigkeitszeile 
immer TRUE, und die folgenden Kommandozeilen werden immer ausgeführt. 
Steht der Hauptdateiname alleine, ist das Ergebnis ebenfalls TRUE. 

Es muß erwähnt werden, daß der Editor für eine Abhängigkeitszeile auch dann 
TRUE setzt, wenn eine Abhängigkeitsdatei in einem Textpuffer steht und dieser 
verändert wurde. Es wird aber nur geprüft, ob die Abhängigkeitsdatei und der 
Puffername dasselbe Namensende haben. Falls das Verzeichnis unterschiedlich 
ist, wird dies eventuell nicht erkannt (siehe auch folgenden Abschnitt). Diese 
Einschränkung ist für den residenten Assembler wichtig. 

Beispiel: Das Makefile lautet 

# Dies ist ein Kommentar 

make.obj: make.asm oraa make.asm 


D.h.: make.obj hängt von make.asm ab. Wenn make.obj nicht existiert oder make.asm 
ein jüngeres Datum als make.obj hat, dann assembliere make.asm. 

Beispiel: 

make.o: make.c 

make.o: make.h 

cc make.c 

und make.c inkludiert make.h. In dem Fall wird make.o produziert, falls make.c oder 
make.h jünger als make.o ist oder make.o nicht existiert. Da mehrere Abhängigkeitsda¬ 
teien in einer Zeile angegeben werden können, lautet das Beispiel verkürzt 

make.o: make.c make.h 

cc make.c 

Statt cc make.c können mehrere Kommandozeilen stehen, z.B. 

cc make.c 
ln make.o -lc 

Die Kommandozeilen sind aber voneinander unabhängig, ein Verzeichniswechsel mit 
dem Shell-Befehl CD ist also in der folgenden Kommandozeile nicht mehr gültig. Für 
diese Fälle kann die Kommandozeile Execute Batchfile mit dem entsprechenden In¬ 
halt von Batchfile als Ersatz benutzt werden; in Batchfile hat der CD-Befehl dann Shell¬ 
gemäß seine Auswirkung auf den DOS-Prozeß. 

Beim Aufruf des Befehls MAKE kann der Name des zu verwendenden Makefiles an¬ 
gegeben werden; falls er fehlt, lautet er makefile. Der Editor liest das Makefile aus 
einem Puffer, wenn der Name des Puffers mit dem Makefilenamen endet, z.B. wie bei 
mein.makefile. Ansonsten wird nach einer Datei im Verzeichnis des aktuellen Puffers 
(bzw. im Heimatverzeichnis des Editors, falls gerade kein Puffer existiert) gesucht, die 
den Namen des Makefiles hat, und diese als Makefile gelesen. Da beim Lesen aus dem 
Puffer nur die Endung des Puffernamens mit dem Makefilenamen gleich sein muß, 
können Sie in einem Verzeichnis mehrere Programme mit ihrem Makefiles unterbringen 
und die Makefiles entsprechend benennen, z.B. die Programme hole.asm und cls.asm 
und ihre Makefiles hole.makefile und eis.makefile. Laden Sie das Makefile dann in einen 
Puffer, so wird es von MAKE bearbeitet werden. Beachten Sie, daß Sie dann notwen¬ 
digerweise das Makefile in einen Puffer laden müssen, da MAKE ohne Argument den 
Namen makefile im aktuellen Verzeichnis sucht. Beachten Sie ferner, daß der Editor den 
ersten Puffer in der Pufferliste nimmt, der das Endungskriterium erfüllt. Ähnliches gilt 
für Textpuffer, die als Abhängigkeitsdateien direkt erkannt werden (siehe oben). 

MAKE schaltet vom Editor-Screen auf die Workbench um, öffnet sein Ausgabefenster 
und arbeitet das Makefile ab, was durch <Ctrl> + <D> unterbrochen werden kann. 
Danach wartet MAKE auf das Drücken der Return-Taste und schaltet zurück auf 
den Editor. Die von MAKE ausgeführten Aktionen lassen sich selber nicht z.B. durch 
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<Ctrl>+<C> abbrechen (Ausnahme: der residente Assembler), der Abbruch erfolgt 
nur beim Wechsel von Makefile-Zeilen. 

Sie können natürlich gerade assemblierte bzw. gelinkte Programme von MAKE 
ausführen lassen, um sie zu testen. Im folgenden Beispiel wird das Programm nur bei 
Bedarf neu assembliert, aber bei jedem Aufruf von MAKE gestartet: 

ram:prg: prg.asm 

oma prg.asm -o ram:prg 

true: ; immer TRUE, wenn Datei "true" nicht existiert (s.o.) 

run ram:prg 

Falls Sie wenig Speicher haben, sollten Sie das Hilfsprogramm Make benutzen, das bis 
auf die Unterstützung des residenten Assemblers die gleichen Möglichkeiten wie das im 
Editor eingebaute MAKE bietet. 

2.8.2 Der residente Assembler 

Eine Besonderheit existiert beim Make-Utility im Zusammenhang mit dem Optimieren¬ 
den Makro-Assembler OMA. Wenn OMA mittels LOADASSEMBLEB resident ist und 
eine Kommandozeile den Befehl OMA (unabhängig von Groß-/Kleinschreibung) enthält 
oder aber über die Befehle OPENASSEMBLE oder ASSEMBLE assembliert werden 
soll, dann wird der residente Assembler gestartet. Er ist dann in der Lage, seine Quellda¬ 
teien aus den Editor-Puffern zu holen, was sehr schnell ist, eine Fehlerliste zu erzeugen 
sowie Programme in den Speicher zu assemblieren, um sie unter dem Editor ausführen 
zu lassen. 

Will der Assembler eine Quelltextdatei öffnen, prüft er nur die Endungen der Pufferna¬ 
men und beachtet nicht, ob der betreffende Text aus dem richtigen Verzeichnis stammt. 
So wird z.B. die Datei make.asm aus dem Directory dfO:examples auch aus dem Puffer 
namens text/make.asm gelesen, dessen Directory z.B. dfl: lautet. Falls mehrere Puffer 
in Frage kommen, wird der in der Pufferliste zuerst vorkommende Puffer genommen. 

Der MAKE-Lauf wird abgebrochen, wenn der Assembler durch <Ctrl>-f<C> unter¬ 
brochen (dies funktioniert nur beim residenten Assembler) oder ein Fehler im Quelltext 
gefunden wurde. Dann sind die Fehlerlisten-Befehle FIRSTERROR etc. im eingeschal¬ 
tet. Sobald Sie vom Make-Utility zurückkehren, wird die erste fehlerhafte Zeile über 
den Befehl NEXTERROR angesteuert. 

Bei der Fehleranwahl schaltet der Editor, falls die Datei in einem Puffer steht, auf den 
Puffer, springt die fehlerhafte Zeile an und meldet den Fehler in der Statuszeile. Danach 
kann normal weitergearbeitet und der Fehler entfernt werden. Falls die Datei nicht in 
einem Puffer steht, führt der Editor OPENNEWFILE aus und lädt dadurch die Datei 
ein. Danach wird die Fehlerstelle angesprungen. 

Diese Behandlung von Fehlern ermöglicht das schnelle Erstellen von assemblierbaren 
Programmen, da der Quelltext so lange im Editor gehalten werden kann, bis der Assem¬ 
blerlauf erfolgreich ist. Die Fehlerliste selber wird bei jedem MAKE-Start und bei den 
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Befehlen CLEARERRORLIST und UNLOADASSEMBLER gelöscht. Über ARexx- 
Programme und den Befehl READERRORLIST ist es möglich, die Fehlerlisten des 
Editors für jeden beliebigen Compiler oder Assembler zu benutzen. 

2.8.3 Assemblieren in den Speicher 

Der Optimierende Makro-Assembler unterstützt das Assemblieren in den Speicher. Da¬ 
mit können Sie bei Quelltexten, die gleich ausführbare Programme ergeben, das Pro¬ 
gramm gleich unter dem Editor starten und kontrollieren. Schalten Sie dazu das »Into 
memory<-Gadget des Assemble-Requester ein und assemblieren Sie normal. Neben der 
normalen Objektdatei-Prodnktion schreibt der Assembler das Programm dabei auch in 
den Speicher. Nachdem Sie in den Editor zurückgekehrt sind, können Sie das Programm 
gleich über den Befehl RUN PROGRAM starten. Dabei können Sie dem Programm al¬ 
lerdings keine Shell-Parameter übergeben, und bei Programmabsturz bleibt auch der 
Editor hängen, und die Pufferinhalte sind verloren! Zudem kann der Debugger DBug 
dabei nicht benutzt werden. 

Das residente Programm wird vor jedem Assemblerstart und beim Befehl UNLOADAS¬ 
SEMBLER gelöscht. 

Das Assemblieren in den Speicher steht auch beim Make-Utility für das jeweils zuletzt 
assemblierte Programm zur Verfügung, wenn Sie bei dem Assembleraufruf die Startop¬ 
tion »-c z< angeben. Beachten Sie aber, daß für das erfolgreiche Assemblieren in den 
Speicher und Starten des residenten Programmes wie oben vier Bedingungen zutreffen 
müssen: 

1. Der Assembler muß resident geladen sein. 

2. Die >-c z<-Startoption muß benutzt werden. 

3. Der Quelltext muß ein ausführbares Programm ergeben, kein linkbares. 

4. Der Assembler darf keine Fehler finden. 

Sollte für den Befehl RUNPROGRAM kein residentes Programm vorliegen, meldet der 
Editor entsprechend einen Fehler. 
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2.9 Die Preferences 

Die Preferences des Editors sind Einstellungen bestimmter Parameter, die die Arbeits¬ 
weise des Editors beeinflußen und während der Laufzeit verändert werden können. Dazu 
gibt es zwei Requester, mit denen die Werte bequem über Gadgets manipulierbar sind. 
Die Preferences lassen sich mit SAVEPREFS abspeichern und mit OPENPREFS oder 
beim Start einladen (siehe 2.9.3 folgend). Wird keine Preferencedatei gelesen, wird eine 
Standardeinstellung verwandt.. Die meisten der einzelnen Werte können auch über die 
Befehle SETPREFS geschrieben und über GETPREFS gelesen werden. 

Bitte beachten Sie bei den Requestern, daß bei Stringeingaben der neue Wert nur 
akzeptiert wird, wenn Sie nach der Eingabe die Return-Taste drücken. Der Wechsel auf 
ein anderes Gadget durch Anklicken genügt nicht. 

2.9.1 Der Standard-Preference-Requester 

Im Standard-Preference-Requester werden normale Editiereinstellungen vorgenommen. 
Der Requester erscheint auf den Befehl OPENPREFWINDOW hin und besitzt die 
folgenden Gadgets: 

Wrap Arouud: Soll der Cursor am Zeilena.nfang/-ende auf die vorige/nächste Zeile 
springen, wenn z.B. "CURSOR right" am Zeilenende befohlen wird? Dies gilt 
auch für "NEXT/PREVIOUS word" und andere Befehle. Die Standardeinstel¬ 
lung ist OFF. 

Save Icons: Sollen Icons für zu speichernde Texte geschrieben werden? Für Texte, 
die schon beim Einladen ein Icon besaßen, wird automatisch wieder dieses Icon 
geschrieben, auch wenn diese Option abgeschaltet ist. Unbekannte Tooltypes läßt 
der Editor im Icon unverändert. Siehe auch dazu Kapitel 2.3.2. Die Standarde¬ 
instellung ist OFF. 

Auto SOL Tabs: Wenn diese Checkbox markiert und TabExpand eingeschaltet ist, 
dann werden vom Zeilenanfang an alle Leer- und Tabulatorzeichen bis zum ersten 
Zeichen, das weder ein Leer- noch Tabulatorzeichen ist, automatisch durch die 
minimale Anzahl von Tabulator- und Leerzeichen aufgefüllt. Dies funktioniert 
dann bei allen Funktionen. Die Standardeinstellung ist ON. 

Complex Words: Normalerweise gehört alles zu einem Wort, was weder Leer- noch 
Tabulatorzeichen ist. Ist diese Checkbox jedoch markiert, dann werden Wörter 
auch durch Zeichen wie Komma, Punkt, Klammern etc. getrennt. Nur Buchsta¬ 
ben, Ziffern und der Unterstrich zählen dann zu einem Wort. Diese Einstellung 
wird bei allen wortorientierten Befehlen berücksichtigt. Die Standardeinstellung 
ist OFF. 

Tab Width, Left Margin, Right Margin sind der Tabulatorabstand, der linke 
Rand und der rechte Rand des aktuellen Textpuffers. Die beiden Ränder wer¬ 
den vertauscht, falls durch die Wahl der rechte Rand links vom linken liegt. Die 
Standardeinstellungen sind 8, 0 und 79. Die Ränder legen z.B. fest, wo für den Be¬ 
fehl NEW LINE die Zeile beginnt und in welchen Grenzen der Wordwrap-Modus 
arbeitet. 
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Global Tab, Global Left, Global Right sind entsprechend die Werte, mit denen 
ein mit dem Befehl NEWFILE oder OPENNEWFILE neu erzeugter Puffer 
anfängt. Die Standardeinstellungen sind 8, 0 und 79. 

Backup Mode: Der Editor kennt verschiedene Methoden, eine Sicherungskopie 
(Backup) einer vorher schon existierenden Datei beim Schreiben eines Puffers 
per SAVEFILE zu erzeugen. Dies ist nur möglich, falls eine alte Datei gleichen 
Namens existiert. Falls kein Backup erstellt werden konnte, meldet der Editor 
dies. Die Standardeinstellung ist OFF. Es gibt drei verschiedene Backup-Modi: 

1. Es wird kein Backup erzeugt (»OFF«), 

2. Falls im Wurzelverzeichnis des Volumes, von der der bearbeitete Text 
stammt, ein T-Verzeichnis existiert, wird der Editor die alte Datei in HiTex- 
Backup umbenennen und sie in dieses T-Verzeichnis verlagern. Ein dort vor 
dem Schreiben vorhandenes Backup geht verloren. Mit diesem Modus haben 
Sie nur vom zuletzt geschriebenen Text ein Backup (>T<). 

3. Der Editor benennt die Datei in einen Namen um, der sich aus dem alten 
Namen und dem Suffix ».bak« zusammensetzt, und läßt es im gleichen 
Verzeichnis. Falls der Name mit ».asm« endet, wird dieses Suffix durch 
».bak« ersetzt. Ein schon vorhandenes Backup mit dem Namen geht verlo¬ 
ren. Mit diesem Modus haben Sie von jeder geschriebenen Datei ein eigenes 
Backup (»BAK«). 

Default Name: Dies bestimmt einen Dateinamen, unter dem der Optimierende 
Makro-Assembler gleich beim Editorstart eingeladen werden kann. Beachten Sie, 
daß dieser Name abgeändert wird, wenn Sie über den Befehl LOADASSEM¬ 
BLER einen anderen Namen für den Assembler wählen. Falls beim Editorstart 
der Assembler-Defaultname angegeben und nicht leer ist, versucht der Editor, 
diese Datei als residenten Assembler zu laden. Dadurch haben Sie Ihre Assembler- 
Programmierumgebung sofort parat. Die Standardeinstellung ist ein leerer Name. 

Console: Dies ist der Dateiname für ein Consolefenster für das Make-Utility 
und die Befehle RUNPROGRAM, OPENASSEMBLE, ASSEMBLE, EXE- 
CAREXXMACRO und EXECAREXXSTRING. Die Standardeinstellung ist 
CON :0/0/640/200/Make. 

File Pattern: Dies ist das Dateimuster, das der Filerequester benutzt. Bitte beach¬ 
ten Sie, daß das Ändern des Patterns im Filerequester diesen Wert hier auch 
verändert und umgekehrt. Die Standardeinstellung ist (~ (#?. inf o)), d.h. alle 
Icon-Dateien ausblenden. 

Das Ok-Gadget schließlich beendet den Requester. 

2.9.2 Der Screen-Preference-Requester 

Dieser Requester enthält Einstellungen, die den Screen wählen, auf dem der Editor ar¬ 
beitet und seine Parameter einstellt. Bei den meisten Einstellungen wird es nötig, alle 
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Fenster zu schließen und erneut zu öffnen und u.U. auch den Screen erneut einzuschal¬ 
ten. Der Requester erscheint auf den Befehl OPENSCREENPREFWINDOW hin und 
besitzt die folgenden Gadgets: 

Smart Refresh: Wenn eingeschaltet, werden neu geöffnete Fenster mit dem Smart- 
Refresh von Intuition ausgestattet. Der Refresh ist dann sehr schnell, benötigt 
aber eine relativ hohe Speichermenge. Ausgeschaltet bekommen die Fenster In- 
tuitions Simple-Refresh. Dieser braucht sehr wenig Speicher, dauert aber länger 
und bedingt bei einigen Editorfunktionen eine höhere Laufzeit (z.B. beim Ziehen 
eines Scrollbars). Diese Einstellung gilt für Textfenster, Hilfsfenster und Reque¬ 
ster. Die Standardeinstellung ist »REFRESH SIMPLE« 

Depth: bestimmt die Tiefe des eigenen, vom Editor geöffneten Screens. Siehe auch 
den folgenden Punkt. 

Screen Name: Hier kann ein Screenname eingegeben werden. Wenn bereits ein 
Public-Screen mit gleichem Namen existiert, öffnet der Editor seine Fenster auf 
diesem Screen (kein Name heißt Workbench). Sonst öffnet er einen eigenen, pri¬ 
vaten Screen und öffnet seine Fenster dort. Der zu besuchende Screen sollte nach 
Möglichkeit mindestens vier Farben haben. Die Standardeinstellung ist ein leerer 
Name, d.h., der Editor arbeitet auf der Workbench. 

Screen Widtli, Screen Heiglxt sind die Breite und Höhe des eigenen Screens in Pi- 
xeln. Diese Werte werden automatisch bei der Videomodus-Wahl gesetzt. 

Video Mode wählt einen Videomodus, wie er auch im System-Preference-Programm 
Screenmode ausgewählt werden kann. Der Videomodus gilt für den eigenen 
Screen. Der in einer Preferencedatei gewünschte Videomodus sollte auf dem Rech¬ 
ner vorhanden sein, sonst startet der Editor nicht richtig, sondern mit dem Stan¬ 
dardmodus. 

Die Gadgets zur Farbauswahl gelten ebenfalls nur für den eigenen Screen. Der ei¬ 
gene Screen bekommt den angewählten Videomodus und die angegebene Far¬ 
beinstellung. »WB Colors« setzt die Farben auf die aktuelle Einstellung der 
Workbench, und »Reset Colors« setzt die Farben auf die alten Werte zu dem 
Zeitpunkt, zu dem der Screen-Preference-Requester geöffnet wurde. Es können 
maximal vier Farben eingestellt werden. 

Select Font...: Hier erscheint ein System-Fontrequester, mit dem der Font bestimmt 
werden kann, der zur Textdarstellung in den Editierbereichen der Textfenster 
benutzt werden soll. Die Standardeinstellung ist der aktuelle System-Default- 
Font, der durch das System-Preference-Programm Font gesetzt wurde. 

2.9.3 Die Preferencedatei 

Wie iin Kapitel 2.2 beschrieben wurde, werden die Einstellungen beim Start aus einer 
Datei gelesen. Der Editor versucht zuerst, eine Datei namens HiTex.prefs zu holen. Ge¬ 
lingt dies nicht, probiert er es noch einmal mit der Datei ACOM:FliTex.prefs. Falls diese 
auch nicht existiert, dann werden die internen Voreinstellungen benutzt. Dieser Lese¬ 
prozeß kann mit der PREFS-Startoption auf eine feste Datei gelenkt werden. Ist diese 
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Startoption angegeben, dann werden die Einstellungen nur aus dieser Datei gelesen. 

Das Format der Preferencedatei ist wie folgt: 

; Dies ist ein Kommentar. 

REFRESH [ SIMPLE | SMART ] 

SCREEN NAME WIDTH HEIGHT VIDEOMÜDE 
DEPTH N 
C0L0R0 RGB 
C0L0R1 RGB 
C0L0R2 RGB 
C0L0R3 RGB 
FONT NAME SIZE 
TABWIDTH WIDTH 
LEFTMARGIN N 
RIGHTMARGIN N 
OPENSIZE WIDTH HEIGHT 
SAVEICONS [ ON | OFF ] 

BACKUPMODE [ OFF | T | BAK ] 

DEFAULTNAME FILENAME 
CONSOLENAME CONSOLENAME 
AUTOSOLTABS [ ON | OFF ] 

COMPLEXWORDS [ ON | OFF ] 

HIDEMOUSE [ ON | OFF ] 

ASLREQUEST [ ON | OFF ] 

WRAPAROUND [ ON | OFF ] 

FILEPATTERN PATTERN 
SEPARATOR WIDTH 
ASSEMBLE OBJECTSTRING OPTIONSTRING FLAGS 

Hat die Datei beim Lesen nur einige Einstellungen statt allen Angaben, werden auch 
nur diese Einstellungen abweichend von der alten Einstellung gesetzt. Die Datei kann 
manuell als Textdatei oder über den Befehl SAVEPREFS erzeugt werden. Die Einstel¬ 
lungen sind dieselben wie oben beschrieben, dazu gibt es noch einige zusätzliche: 

OPENSIZE: Bestimmt, mit welcher Anfangsgröße sich Textfenster öffnen sollen. Ist 
die Breite WIDTH negativ, dann werden die Textfenster so groß geöffnet, wie es 
der sichtbare Screenbereich zuläßt. D.h. bei scrollbaren Screens, daß das Fenster 
niemals größer als der sichtbare Bereich wird. Die Größe kann auch durch den 
Befehl FETCHOPENSIZE gesetzt werden. Die Standardeinstellung ist WIDTH = 
- 1 . 

HIDEMOUSE: Bestimmt, ob die Maus abgeschaltet werden soll, wenn eine Taste 
gedrückt wird. Dies ist auf normalen Amigas zu bevorzugen, da dann der Maus¬ 
zeiger eingegebenen Text nicht verdecken kann. Die Standardeinstellung ist ON. 
Wenn eine Grafikkarte benutzt wird, mit der sich Probleme im Zusammenhang 
mit dem Mauswegschalten ergeben, dann sollte hier OFF eingestellt werden. 


; der globale Wert 
; der globale Wert 
; der globale Wert 
; Offnungsgröße für Textfenster 

; Dateiname des Assemblers 
; Dateiname der Console für Make u.ä. 

; Mauszeiger bei Taste abschalten? 

; Standard-Filerequester benutzen? 

; Höhe der Editierbereich-Trennzeile 
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ASLREQUEST: Wie im Kapitel über den Filerequester beschrieben, wählt diese 
Einstellung aus, ob der System-Standard-Filerequester verwendet wird (ON) oder 
der dem Editor eigene Filerequester. Die Standardeinstellung ist OFF. 

SEPARATOR: Die Pixelhöhe der Trennzeilen zwischen Editierbereichen in Textfen¬ 
stern. Die Standardeinstellung ist vier. 

ASSEMBLE: Hier ist die Einstellung des Assemble-Requesters abgespeichert. Die 
einzelnen Flagstellen sind Nullen oder Einsen in der Reihenfolge der Flags im 
Assemble-Requester. 


2.10. KONFIGURATION DES EDITORS 
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2.10 Konfiguration des Editors 

Eine wesentliche Eigenschaft des Editors ist die freie Konfigurierbarkeit. von Menüs 
und Tastaturkommandos. Beim Start des Editors versucht er, eine Textdatei namens 
HiTex. setup aus dem aktuellen Verzeichnis zu lesen (bzw. beim Workbenchstart aus dem 
Verzeichnis, aus dem er geladen wurde). Gelingt dies nicht, probiert er es noch einmal im 
ACOM:- Verzeichnis mit dem gleichen Namen. Schlägt auch das fehl, wird die interne 
Standardkonfiguration benutzt. Sollte eine Setup-Datei über die SETUP-Startoption 
gewählt worden sein, so hat sie Vorrang vor den oben genannten Versuchen. 

Die Setup-Datei besteht aus zwei Teilen. Der erste Teil konfiguriert die Menüeinstellung, 
der zweite die Tastaturkommandos. 


2.10.1 Menükonfiguration 

Um die Syntax der Menükonfiguration *zu erläutern, ist hier ein Ausschnitt aus der 
Standardkonfiguration abgedruckt: 

TITLE Project 
ITEM New NewFile N 
ITEM Open... OpenFile 0 
ITEM "Open New..." OpenNewFile 
BAR 

ITEM Save SaveFile S 
ITEM "Save as..." SaveFileAs A 
ITEM "Save modified files" SaveModifiedFiles 
ITEM "Save & Quit" SaveFileQuit 
BAR 

ITEM Rename... SetFilePath 
ITEM "Set home dir..." SetHomeDir 
ITEM Print PrintFile 
BAR 

ITEM Hide HideFile 
ITEM Clear ClearFile 
ITEM Close CloseFile 
BAR 

ITEM Make... Make 5 
BAR 

ITEM Quit Quit Q 

TITLE Block 
ITEM Cut CutBlk X 
ITEM Copy CopyBlk C 
ITEM Paste Paste V 
ITEM "Unmark block" UnmarkBlk K 
BAR 
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ITEM "Delete block" DeleteBlk 

ITEM "Save block" SaveBlk 
BAR 

ITEM "Shift left" ShiftLeft 

ITEM "Shift right" ShiftRight 
BAR 

ITEM Case 

SUB Upper "UpperCase Block" 

SUB Lower "LowerCase Block" 

SUB Swap "SwapCase Block" 

BAR 

ITEM Expand Conv2Spaces 

; und so weiter. Dies hier ist übrigens ein Kommentar. 

; Der Menüteil muß mit folgendem Schlüsselwort beendet werden: 

MENUEND 

Es sind Leerzeilen sowie Kommentarzeilen erlaubt. Ein Kommentar wird an dem Semi¬ 
kolon als erstem Zeichen erkannt. Wie leicht ersichtlich ist, müssen alle Worte, die Leer¬ 
oder Tabulatorzeichen enthalten sollen, in Hochkommata eingefaßt werden, die ande¬ 
ren dürfen optional Hochkommata haben. Dabei ist sowohl ein einfaches ’ als auch ein 
doppeltes Hochkomma " möglich. In den Texten ist der Backslash das Fluchtsymbol, 
also erzeugt \" ein einzelnes Doppelhochkomma und \\ nur einen einzelnen Backslash. 
Die Worte werden durch Leer- oder Tabulatorzeichen getrennt. 

Für jede Zeile gibt es ein Schlüsselwort, das die Bedeutung der Zeile anzeigt und un¬ 
abhängig von Groß-/Kleinschreibung erkannt wird. TITLE leitet ein neues Menü ein, 
das rechts vom vorigen Menü erscheinen wird. Sein Argument ist der Text, der als 
Menü-Überschrift angezeigt werden soll. ITEM ist ein einzelner Menüpunkt mit einem 
Anzeigetext und einem ARexx-Befehl, der bei Auswahl des Menüpunktes intern auf¬ 
gestartet wird (siehe ARexx-Kapitel). Zusätzlich ist ein Tastaturkürzel erlaubt (siehe 
oben). Der Anzeigetext für den Menüpunkt darf beliebig sein (z.B. Deutsch). Falls kein 
ARexx-Befehl angegeben wird, bereitet ITEM ein Untermenü vor. Die Zeilen des Un¬ 
termenüs haben SUB statt ITEM als Schlüsselwort. Das Schlüsselwort BAR schließlich 
setzt eine Trennzeile zwischen zwei Menüpunkte. Es ist nicht möglich, eine Trennzeile 
in einem Untermenü zu setzen, setzen Sie also nie BAR zwischen die Punkte eines 
Untermenüs. Der Menüteil wird mit MENUEND beendet. 


2.10.2 Tastenkonfiguration 

Nach MENUEND sind die Tastenkombinationen angegeben, die Befehle auslösen 
können. Die Kombinationen überlagern die normale Ansteuerung, d.h., Drücken der 
k-Taste kann anstelle der Ausgabe »k« eine Funktion auslösen. Die Syntax einer De¬ 
finitionszeile ist (Kommentare wie oben): 

TastenID ARexxBefehl Qualifierl Qualifier2 . . . 
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Ein Qualifier ist SHIFT, ALT, LAMIGA, CONTROL oder keiner und wird unabhängig 
von der Groß-/Kleinschreibung erkannt. Der Qualifier entspricht den gleichnamigen Ta¬ 
sten, dabei ist LAMIGA die linke Amiga-Taste (die rechte Amiga-Taste ist den Kürzeln 
für die Menüs Vorbehalten). Es dürfen mehrere bzw. gar keine Qualifier angegeben wer¬ 
den. Der ARexx-Befehl ist derjenige, der bei Erkennen der Tastenkombination ausgelöst 
wird. TastenID ist entweder ein ASCII-Buchstabe oder ein Mnemonic. Der ASCII- 
Buchstabe muß in korrekter Kleinschreibung angegeben sein, d.h. nicht in Großbuch¬ 
staben, da der Qualifier angibt, ob z.B. gleichzeitig die Shift-Taste verlangt wird. Ein 
Mnemonic ermöglicht es, Spezialtasten zu erreichen. Es gibt die folgenden Mnemonics, 
die ebenfalls unabhängig von der Groß-/Kleinschreibung erkannt werden: 

ESCAPE, Fl, F2, F3, F4, F5, F6, F7, F8, F9, F10, BACKSPACE, DELETE, 
HELP, TABULATOR, RETURN, CURSORUP, CURSORLEFT, CURSGRDGWN, 
CURSORRIGHT 

Mnemonics für den seitlichen Zehnerblock sind: 

PAD[, PAD], PAD/, PAD*, PAD-, PAD+, PADO, PAD1, PAD2, PAD3, PAD4, 
PAD5, PAD6, PAD7, PAD8, PAD9, PAD., ENTER 

Aus den Namen geht sehr klar hervor, welche Taste jeweils gemeint ist. Nicht definierte 
Tastenkombinationen bewirken dasselbe, was sie normalerweise auf der eingestellten 
Tastatur bewirken. Daher sollten einige Einstellungen wie z.B. die folgenden immer in 
der Setup-Datei enthalten sein: 

DELETE Delete 
BACKSPACE Backspace 
RETURN Newline 
ENTER Newline 

Ein und derselben Taste können auch mehrere Kombinationen mit unterschiedlichen 
Qualifiern diktiert werden: 

CURSORUP "Cursor Up" 

CURS0RD0WN "Cursor Down" 

CURSORLEFT "Cursor Left" 

CURSORRIGHT "Cursor Right" 

CURSORUP "Position SQV" SHIFT 
CURSORDOWN "Position EOV" SHIFT 
CURSORLEFT "Position SOL" SHIFT 
CURSORRIGHT "Position EOL" SHIFT 
CURSORUP "Previous Page" ALT 
CURSORDOWN "Next Page" ALT 
CURSORLEFT "Previous Word" CONTROL 
CURSORRIGHT "Next Word" CONTROL 
CURSORUP "Position SOF" CONTROL SHIFT 
CURSORDOWN "Position EOF" CONTROL SHIFT 
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Die Tastenkonfiguration endet mit dem Dateiende der Setup-Datei. Als Abschlußbei¬ 
spiel soll bei Drücken von <Control>+<n> der nächste Fehler der Fehlerliste ange¬ 
sprungen werden: 

n NextError CONTROL 

Eine wichtige Einschränkung gilt, wenn das Pufferlisten-, Marken- oder Findfenster ak¬ 
tiv ist. Dann werden nur solche Tastendrücke ARexx-Befehle auslösen, die von Tasten 
kommen, welche keine ASCII-Buchstaben bzw. -Zeichen erzeugen, d.h. nur von Funk¬ 
tionstasten, Help-Taste, Cursor-Tasten etc. Das obige <Control>+<n> würde also 
verschluckt, wenn das Pufferlistenfenster gerade aktiv ist. 

2.10.3 Ausgeschaltete Menüs und Checkmarks 

Der Editor ist in der Lage, bei ARexx-Befehlen auf Menüpunkten die Punkte aus¬ 
zuschalten ( ghosting ) oder mit einem Checkmark zu versehen. Da dies einen hohen 
internen Aufwand verursacht, ist dies nur für einige wichtige Befehle implementiert, 
ferner sollte bei dem Befehl SETPREFS darauf geachtet werden, daß nach dem Befehl 
genau ein Leerzeichen folgt und darauf gleich der Name des zu beeinflußenden Para¬ 
meters, ansonsten wird der Menüpunkt nicht richtig mit einem Checkmark versehen 
(siehe Standardkonfiguration). Korrekt ist z.B. 

ITEM Overstrike "SetPrefs Overstrike Toggle" 


Kapitel 3 


Optimierender 
Makro-Assembler V2.1 

3.1 Einführung 

Dieses Assembler-Handbuch dient nicht als Einführung in die Programmierung der 
Prozessoren der Motorola-68000-Familie. Dafür gibt es im Buchhandel sehr gelungene 
Werke verschiedener Autoren, auf die ich hier verweisen möchte. Es wird vorausgesetzt, 
daß Sie die gängige Terminologie für 68000-Assembler kennen. 

Nach diesem Hinweis möchte ich Sie beim Optimierenden-Makro-Assembler herz¬ 
lich willkommen heißen. OMA ist einer der leistungsfähigsten, für die Commdore- 
Amiga-Familie erhältliche Makro-Assembler. Neben seiner hohen Geschwindigkeit be¬ 
sitzt OM A Kompatibilität zum HiSoft-Devpac-Assembler V2.0 sowie zum Metacomco- 
Makro-Assembler V11.00, der den ersten Standard für Assembler auf dem Amiga ge¬ 
setzt hat. Genauere Unterschiede finden Sie im Kapitel 3.7. 

OMA ist als Nachfolger des Metacomco-Assemblers gedacht und unterstützt den 
Motorola-Standard für 68000-Assembler. Zum Konzept gehört die möglichst unein¬ 
geschränkte Benutzung aller Funktionen, so daß z.B. Makros oder Includefiles beliebig 
tief geschachtelt werden können. Die vielen präzisen Fehlermeldungen helfen, Quelltexte 
schnell zu korrigieren, wobei Sie besonderen Komfort genießen, wenn Sie den Assembler 
in den Editor integrieren (dazu sehen Sie bitte im Editor-Handbuch nach). 

OMA erzeugt Code für alle Mitglieder der Motorola-68000 Familie, auch für PMMUs 
und FPUs. Ich erwähne im folgenden ausdrücklich, wo ein Unterschied zwischen den 
einzelnen Prozessoren besteht. OMA verarbeitet als Quelltexte normale ASCII-Dateien, 
wie sie von üblichen Editoren erzeugt werden, und erzeugt Objektfiles oder direkt 
ausführbare Programme im Amiga-DOS-Hunkformat. Durch diese Standardisierung 
ist es möglich, den zum OMA-Paket gehörenden HiTex-Editor oder den Linker DLink 
durch Ihren Lieblings-Editor oder -Linker zu ersetzen. Obwohl dabei die Möglichkeit 
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verlorengeht, Editor und Assembler zu einem integrierten Paket zusammenzusetzen, 
gibt dies Ihnen größere Flexibilität im Umgang mit dem Paket. 

Hier noch eine kleine Zusammenfassung der Leistungsmerkmale des Assemblers: 

• kennt 68000, 68010, 68020, 68030, 68040, 68881, 68882, 68851 

• unterstützt Source-Level-Debugging 

• unterstützt objektorientierte Programmierung, siehe 7 

• kompatibel zum Devpac- und Metacomco-Assembler, Zusatzdirektiven 

• kommandozeilen-kompatibel zum Metacomco, Zusatzoptionen 

• läuft auf allen Amiga-Betriebssystemversionen 

• ab Workbench 1.3 resident haltbar 

• über 300 Fehlermeldungen und Warnungen 

• Listingerzeugung und -formatierung wie Metacomco, Zusatzdirektiven 

• Direktiven sind redefinierbar, daher mögliche Cross-Assemblierung für andere 
Prozessoren 

• beliebig viele Include-Directories, ein Default-Include-Directory 

• Zeilenlänge bis zu 255 Zeichen, freies Zeilenformat 

• Symbollänge bis zu 255 Zeichen, beliebig viele Symbole 

• beliebige Makrogröße und -Verschachtelung 

• 36 Makroparameter plus Null-Parameter, Weiterzähl-Parameter und Spezial- 
Makrobefehle 

• beliebige Includefile-Verschachtelung 

• beliebige Verschachtelung von IF-Direktiven 

• bis zu 255 Sektionen 

• Ausdruckschachtelung bis zu 32 Klammern 

• stellenweise oder global ein- und ausschaltbarer Optimierer erzeugt hochoptimier¬ 
ten Code 

• hochoptimierender Mehrpass-Modus 

• hohe Assembliergeschwindigkeit: ca. 63000-74000 Zeilen pro Minute, Peak- Ge¬ 
schwindigkeit von 200000 Zeilen pro Minute (NOPs) 

• wenn in den Editor integriert: direktes Assemblieren aus den Editorpuffern, di¬ 
rektes Fehleranspringen und Assemblieren in den Speicher 

• kann direkt ausführbare Programme erzeugen 

• vorassemblierte Includehles möglich 

• »Small data«-Modell (siehe Kapitel 3.11) 

• geringer Speicherbedarf 


3.1. EINFÜHRUNG 
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Zum Abschluß dieses Kapitels möchte ich noch ein paar terminologische Erklärungen 
machen: 

Ich verwende »PC« für den Program Counter des Prozessors, während 
»Programmzähler« sich auf den internen Zähler des Assemblers bezieht , der bestimmt, 
wo der erzeugte Code im Programm zu liegen kommt. Ein Begriff, der in eckige Klam¬ 
mern eingefaßt ist, ist optional, kann also weggelassen werden oder darf höchstens 
einmal angegeben sein, z.B. »[Label]«. 

In allen Fällen, in denen der Assembler für Direktiven Strings als Operanden liest, darf 
der String auch in einfache oder doppelte Hochkommata eingefaßt sein und kann dann 
Leerzeichen enthalten. Soll dann das einfassende, einfache bzw. doppelte Hochkomma 
selber in dem String erscheinen, muß es zweimal angegeben werden, z.B. ’Was”n das’ 
oder "Was""n das". Diese Regeln möchte ich als übliche Regeln für Assemblerstrings 
vereinbaren. Eine Ausnahme hiervon bilden Symbolstrings. 

Den Begriff »Case-Unterschied« verwende ich aus verständlichen Gründen an solchen 
Stellen, an denen eigentlich »Unterschied zwischen Groß- und Kleinschreibung« stehen 
sollte. »Groß- und Kleinschreibung« bezieht sich hier aber auf alle Buchstaben eines 
Strings, nicht nur auf den ersten! 

Für weitergreifende Beispiele in der Programmierung des Assemblers verweise ich 
auf das Exam ples- Directory der Originaldiskette. Dort finden Sie Beispiele für IF- 
Verschachtelungen, Makros usw. in Hülle und Fülle. 

Es soll nicht unerwähnt bleiben, daß der Assembler seine Tauglichkeit im Alltagsbetrieb 
schon bewiesen hat: Das komplette Assemblerpaket wurde mit OMA selber geschrieben! 
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3.2 Aufruf des Assemblers 

3.2.1 Aufruf 

Der Assembler kann nur über einen CLI-Aufruf (und damit auch z.B. durch das Make- 
Utility des Editors) oder über den Assemble-Requester des Editors gestartet werden. 
Er versteht Dateinamen in der CLI-Syntax, so daß der Parameterstring »a**b ist c« 
den Namen »a*b ist c« ergibt. Wenn Quellfile der Name des zu assemblierenden Files 
ist, lautet die Aufrufsyntax: 

OHA [PR0G|FR0M] Quellfile [HauptOptionen] 

PROG oder FROM darf optional dem Quellfile-Namen vorangestellt werden. Wenn der 
Assembler das Quellfile nicht öffnen kann und dieser Name nicht mit ».asm« endet, 
versucht er, das File mit dem Suffix ».asm« zu öffnen, d.h. z.B. Quellfile.asm. Dieses 
Suffix ist die Standardendung im Assemblerquelltexte. Beachten Sie, daß bei Weglassen 
des Suffix evtl, ein anderes File als der von Ihnen gewünschte Quelltext assembliert 
wird! 

Hauptoptionen dürfen weggelassen werden. Für sie gibt es die folgenden Möglichkeiten: 
-o Objektfile 

Mit dieser Option erhält das Objektfile den Namen Objektfile. Fehlt sie, dann 
erhält das Objektfile einen Namen, der sich aus dem Quellfile-Namen ohne evtl, 
vorhandene ».asm«-Endung und dem Suffix ».obj« ergibt. Ist das Objektfile 
jedoch ein ausführbares Programm, entfällt das ».obj«-Suffix. Siehe auch OUT¬ 
PUT-Direktive. 

-1 Listingfile 

Mit dieser Option erzeugt der Assembler ein Listingfile namens Listingfile. Diese 
Option kann nicht zusammen mit der »-c l«-Opt,ion benutzt werden, und der 
Fast-Modus wird ausgeschaltet (siehe Option »-n«). Der Assembler erzeugt ein 
Listingfile nur auf Befehl. Siehe auch Kapitel 3.12. 

-v Meldungsfile 

Mit dieser Option leiten Sie die Standardmeldungen des Assemblers vom Termi¬ 
nal (dem aktuellen CLI-Fenster) in das File Meldungsfile um. Beachten Sie, daß 
dies nicht das Listingfile beeinflußt und daß dadurch während der Assemblierung 
keine Ausgabe in das CLI-Fenster erfolgt. 

-h Headerfile 

Mit dieser Option befehlen Sie dem Assembler, vor jedem Pass zusätzlich das 
Includefile Headerfile zu inkludieren. Dies kann nützlich sein, um Makros ein¬ 
zubeziehen, die für die Kompatibilität zu anderen Assemblern zuständig sind. 
Siehe Kapitel 3.7 und die INCLUDE-Direktive. 


-e Equatefile 
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Mit dieser Option schreiben Sie alle Quelltextzeilen des Assemblerdurchlau¬ 
fes, die Zuweisungen wie z.B. EQU, EQUR, RS, OFFSET und dessen DS- 
Zuweisungen enthalten, in das File Equatefile. Dadurch erhalten Sie eine Zu¬ 
sammenfassung aller Zuweisungszeilen des assemblierten Quelltextes. 

-t Tabellenfile 

Mit dieser Option werden alle absoluten Symbole und Makros des Assembler¬ 
laufes in einem speziellen Format in das File Tabellenfile geschrieben. Sie können 
damit Includefiles vorassemblieren und so Zeit für einen Assemblerlauf sparen. 
Siehe Kapitel 3.13. 

-p Tabellenfile 

Mit dieser Option wird das durch die »-t,«-Option erzeugte File Tabellenfile 
vor dem Assemblerlauf eingelesen, und seine Symbole und Makros werden in 
die Assemblierung einbezogen. Ein vorassembliertes File kann auch mit der IN- 
CPRE-Direktive gelesen werden. Siehe Kapitel 3.13. 

-s 

Der Assembler gibt am Ende der Assemblierung eine Statistik über den Assem¬ 
blerlauf aus. Diese enthält die Größe der insgesamt erzeugten Sektionen, eine 
Angabe über den Speicherbedarf, die Laufzeit und die Anzahl der insgesamt 
sowie die Anzahl der pro Minute assemblierten Zeilen. 

-m 

Schaltet den Mehrpass-Modus ein. Siehe Abschnitt 3.2.2 unten. 

-n 

Der Fast-Modus wird ausgeschaltet. Siehe Abschnitt 3.2.2 unten. 

-d Symbol[:Wert] 

Diese Option definiert das absolute Symbol Symbol für den Assemblerlauf. Wenn 
der optionale Hexadezimalwert Wert (durch einen Doppelpunkt von Symbol ge¬ 
trennt) angegeben wird, bekommt Symbol diesen Wert statt normalerweise 0. 
Wert darf nicht den Hexadezimal-Vorsatz »$« haben. Diese Option ermöglicht 
Ihnen, durch Steuerung von außen und IF-Direktiven Quelltext-Abschnitte vom 
Assemblerlauf auszuschließen oder einzubeziehen. 

-i Includedirectory 

Sie können mit dieser Option Directories zum Suchen von Includefiles ange¬ 
ben (siehe INCLUDE-Direktive). Es sind mehrere Directories möglich, wenn 
Sie die »-i«-Option mehrfach anwenden oder nur eine »-i«-Option verwenden 
und die einzelnen Directorynamen durch ein Pluszeichen oder Komma tren¬ 
nen, z.B. »-i a+b« oder »-i a.,b«. Soll ein Directoryname ein Pluszeichen, 
Leerzeichen oder Komma enthalten, muß er durch eine einzelne »-i«-Option 
angegeben werden und in Hochkommata eingefaßt sein (CLI-Konvention). Sie 
dürfen beliebig viele Include-Directories angeben. Wenn in Ihrem System ein 
Directory namens AINC: existiert, erkennt der Assembler dies automatisch und 
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benutzt es, als ob es als letztes Include-Directory mit der >-i<-Option angege¬ 
ben wäre. Sie können also die Angabe eines Standard-Includedirectories vermei¬ 
den, wenn Sie z.ß. assign ainc: dfO:include unter dem CLI ausführen las¬ 
sen (evtl, in der Startup-Sequenz). Obwohl Includefiles gelesen werden, lautet 
der Assembler-Aufruf dann z.B. nur noch GMA m.asm. Das Standard-Directory 
(Default-Includedirectory) AINC: wird erst nach allen anderen Directories durch¬ 
sucht. 

-c Nebenoptionen 

Der Assembler schaltet Nebenoptionen ein, die ungetrennt direkt hinterein¬ 
ander stehen müssen. Für die »c«-Option existiert das Synonym »OPT 
Nebenoptionen«. 

Gültige Nebenoptionen für >-c« sind: 

c Es gibt keinen Gase-Unterschied der Symbole. Alle Symbole gelten als großge¬ 
schrieben und gelangen auch so in das Objektfile. Das bedeutet u.U., daß Sie 
beim Linken mit DLink die NOCASE-Startoption angeben müssen. 

d Lokale Label werden nicht ins Objektfde (in den Hunk_Symbol) gelistet. 

k Das Listing wird vorerst in IF-Direktivenabschnitten mit Falsch- Resultaten un¬ 
terdrückt. Diese Option kann durch die CLIST- und NOCLIST-Direktiven un¬ 
wirksam gemacht werden (siehe auch dort). 

1 Der Assembler erzeugt ein Listingfile, dessen Name sich aus dem Quellfilenamen 
ohne evtl, vorhandene >.asm«-Endung und dem Suffix ».Ist« ergibt. Der Fast- 
Modus wird ausgeschaltet. Diese Option kann nicht zusammen mit der »-1«- 
Option benutzt werden. 

m Das Listing wird während der Makroexpansion unterdrückt. Diese Option kann 
durch die MLIST- und NOMLIST-Direktiven unwirksam gemacht werden (siehe 
auch dort). 

n Die Produktion eines Objektfiles wird verhindert. Sie können dies zum schnellen 
Test von Quelltexten verwenden. Siehe auch NOOBJ-Direktive. 

o Der Optimierer wird vorerst abgeschaltet. Diese Option kann durch die 
OPTIMIZE- und NOOPTIM-Direktiven bzw. durch »OPT o« unwirksam ge¬ 
macht werden (siehe auch dort). 

p Es wird vorerst kein Seitenvorschub im Listing erzeugt. Diese Option kann durch 
die PAGE- und NO PAGE-Direktiven unwirksam gemacht werden (siehe auch 
dort). 

q Mit dieser Option werden zum Source-Level-Debuggen Quelltextzeilen in einem 
speziellen Format in einen Debughunk abgespeichert. Siehe auch Kapitel 3.14 
über Source-Level-Debugging. 

s Der Assembler schreibt die relativen Symbole ins Objektfile in einen Symbol- 
hunk. Solch ein Programm kann dann in Verbindung mit einem symbolischen 
Debugger leicht lesbar gemacht werden. Zur Entfernung der Symboltabellen ans 
Programmen, Objektfiles und Libraries sehen Sie sich bitte das Hilfsprogramm 
Strip an. 
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t Nach dem Assemblerlauf wird eine Symboltabelle in das Listingfile gegeben. Siehe 
Kapitel 3.12. 

w Sogenannte Warnings, d.h. Warnungen des Assemblers, die auf merkwürdige 
Zustände hinweisen und keine Fehler sind, werden unterdrückt. Siehe Kapitel 
3.10. 

x Nach dem Assemblerlauf wird eine Cross-Referenz in das Listingfile gegeben. 
Siehe Kapitel 3.12. 

z Diese Option wählt das Assemblierer! in den Speicher an und hat nur eine Aus¬ 
wirkung, wenn der Assembler unter dem Editor resident ist. Sie werden diese 
Option benutzen, wenn Sie mit dem Editor-Make-Utility assemblieren und das 
erzeugte Programm direkt unter dem Editor ausführen lassen möchten. Beachten 
Sie, daß diese Option die Objektfile-Produktion nicht beeinflußt. 

Es gibt keinen Gase-Unterschied für die Options-Buchstaben, weder für Haupt- noch 
für Nebenoptionen. Soll der Quellfilename die Form »-?« haben (>?« steht für irgend¬ 
ein Zeichen), muß er in Hochkommata eingefaßt sein, damit er nicht für eine Option 
gehalten wird. 

Der Assembler erzeugt automatisch direkt ausführbare Programme, wenn im Quelltext 
weder XREF- noch XDEF-Direktiven Vorkommen (ein völlig abgekapseltes Modul wäre 
schwer zu linken, womit auch?), sonst nur linkbare Objektfiles, da Referenzen nicht 
aufgelöst sind. Es ist jedoch möglich, mit der Direktive »OPT L+« oder »OPT L-« 
zwingend zwischen linkbar und ausführbar zu wählen. 

3.2.2 Fast-Modus und Mehrpass-Modus 

Normalerweise arbeitet der Assembler immer im Fast-Modus. Dieser schnelle Modus 
wird nur durch die »-n«-Option, das Erzeugen eines Listingfiles oder das Auftreten 
von Fehlern im ersten Pass abgeschaltet. Der Fast-Modus ist schnell, da der Quelltext 
im zweiten Pass nicht mehr gelesen werden muß, schluckt aber viel Speicher. Deswegen 
können Sie mit der »-n«-Option Platz sparen und sehr große Quelltexte assemblieren, 
verlieren dann aber an Geschwindigkeit. Bitte beachten Sie, daß Quellzeilen bei Fehler¬ 
meldungen im zweiten Pass des Fast-Modus leicht umformatiert ausgegeben werden. 

Der Mehrpass-Modus wurde geschaffen, damit Sie leicht hochoptimierten Code erzeu¬ 
gen können. Sie schalten ihn mit der »-m«-Option ein, und es werden so lange neue 
Quelltext-Durchläufe (Passes) eingeschoben, bis der Assembler den Code nicht mehr 
stärker optimieren kann. Diesen Modus sollten Sie verwenden, wenn Ihr Programm 
fertig ist, da er prinzipbedingt sehr langsam arbeitet. 

3.2.3 Beispielaufrufe 

OMA prog.asm 
OMA prog 
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Assembliert prog.asm als Objektfile prog.obj bei Benutzung des Fast-Modus. Da 
der Assembler automatisch die >.asin<-Endung anhängt, darf beim zweiten 
Beispiel kein File namens prog existieren, damit prog.asm assembliert wird. 

OMA prog.asm -o Prog -1 * -i includel -i include2 OPT pwt -s 

OMA prog.asm -o Prog -1 * -i includel+include2 OPT pwt -s 

OMA prog.asm -o Prog -1 * -i includel,include2 OPT pwt -s 

Assembliert prog.asm als Objektfile Prog, schreibt das Listing zum Terminal, 
benutzt die Includedirectories includel und include2, unterdrückt den List.ing- 
Seitenvorschub und die Warnings und gibt am Ende die Symboltabelle ins Li¬ 
sting sowie eine Statistik über den Assemblerlauf zum Terminal. 

OMA prog.asm -m -c s -d DEBUG 

Assembliert prog.asm als Objektfile prog.obj im hochoptimierenden Mehrpass- 
Modus, schreibt die Symboltabelle ins Objektfile und definiert das absolute 
Symbol DEBUG im den Assemblerlauf (mit dem Wert 0). Im Quelltext können 
Abschnitte per IFD- und IFND-Direkt.ive ein- oder ausgeschlossen werden. 

3.2.4 Anhalten des Assemblers 

Sie können den Assembliervorgang jederzeit mit <Ctrl>+<c> anhalten. 
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3.3 Die Zeilensyntax 

3.3.1 Die Syntax 

Der Assembler verarbeitet Zeilen aus normalen ASCII-Dateien. Ein Zeilenende liegt 
vor, wenn das ASCH-Zeichen $0A (Linefeed), das ASC'II-Zeichen $0D (Carriage Re¬ 
turn) oder die Folge $0D $0A (Carriage Return - Linefeed) gefunden wird. Der zum 
OMA-Paket gehörende HiTex-Editor erzeugt als Zeilenende ein einzelnes Linefeed. Eine 
Zeile darf maximal 255 Zeichen lang sein, die restlichen Zeichen werden nicht mehr 
berücksichtigt, sondern überlesen, und es wird ein Warning erzeugt. 

Eine Kommentarzeile ist eine leere Zeile oder eine mit einem Stern »*« als erstem 
Zeichen. Kommentarzeilen werden ignoriert und lösen keine Aktion aus. 

Alle anderen Zeilen dürfen höchstens eine Assembler-Direktive enthalten und müssen 
der folgenden Syntax gehorchen: 

[Label][:] [Opcode][.Size] [Operanden] [Kommentar] 

Label darf bei den meisten Direktiven weggelassen werden und optional mit einem 
Doppelpunkt enden. Der Doppelpunkt muß angegeben werden, wenn Label nicht auf 
dem ersten Zeichen der Zeile beginnt. Label ist der Ausdruck für dieses Feld; wenn 
eine Variable, Konstante oder ein Makro selber gemeint ist, wird der Ausdruck Symbol 
verwandt. Eine Größenangabe wie Size ist am Ende vom Label nicht zulässig. Ein 
normales Label gehorcht den gleichen Bedingungen wie der Opcode (siehe folgend), 
aber beachten Sie unbedingt, daß lokale Label bzw. Symbole eine andere Syntax haben 
(siehe unten). 

Opcode ist eine Prozessorinstruktion, eine Assemblerdirektive oder ein Makroname. 
Der Opcode muß mit einem Buchstaben, Punkt oder Unterstrich beginnen und darf 
danach zusätzlich eine Dezimalziffer enthalten. Als Buchstaben sind auch internationale 
Zeichen wie z.B. »ö« oder »ae« zulässig. Siehe auch Kapitel 3.6. 

Size ist eine optionale Größenangabe für den Opcode und muß, falls angegeben, durch 
genau einen Punkt getrennt direkt hinter dem Opcode stehen. Eine Größenangabe ist 
für manche Opcodes nicht zulässig. 

Operanden gibt es nur, wenn der Opcode solche besitzen kann, sonst gelten sie als 
Kommentar. Mehrere Operanden werden durch Kommata getrennt und dürfen keine 
Leer- oder Tabulatorzeichen enthalten. Ein Ausnahme hiervon bilden Parameter beim 
Makroaufruf, dort darf ein in spitze oder eckige Klammern eingefaßter Parameter Leer¬ 
oder Tabulatorzeichen enthalten. 

Kommentar ist optional und muß mit einem Semikolon beginnen, sofern es keinen Op¬ 
code gibt. Sonst ist cs egal, mit welchem Zeichen der Kommentar beginnt. Sie sollten 
ihn aber wegen Quelltextkompatibilität zu anderen Assemblern immer mit einem Se¬ 
mikolon einleiten. 

Die einzelnen Felder müssen mit mindestens einem Leer- oder Täbulatorzeichen ge¬ 
trennt sein. Die einzige Ausnahme ist der Opcode > = < als Synonym für EQU, vor 
und hinter dem Label und Operand direkt stehen dürfen. Die Syntax entspricht der des 
Devpac- und Metacomco-Assemblers und bietet beliebig formatierbare Quelltexte. 
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3.3.2 Lokale Symbole 

Ein lokales Symbol ist nur zwischen der Definition von zwei »echten«, relativen Sym¬ 
bolen gültig. Es gilt als lokal, wenn es mit einer Dezimalzahl beginnt und als letztes 
Zeichen das Dollarzeichen »$« hat. Beispiel: 


Start 

nop 



nop 


1$ 

move.b (aO)+,(al)+ 

; lokale Definition 


bne.s 1$ 

; bezieht sich auf das vorige "1$" 

ende 

bra.s 1$ 

; bezieht sich NICHT auf das obige "1$ 


Ein Symbol gilt ebenfalls als lokal, wenn es mit einem Punkt beginnt: 

Start nop 
nop 

.lab move.b (a0)+,(al)+ 
bne.s .lab 

ende 

bra.s .lab ; bezieht sich NICHT auf das obige ".lab" 

Sie können das Einleitungszeichen Punkt in den Unterstrich »_« ändern, indem Sie die 
Direktive »OPT U+< verwenden (siehe auch dort): 

opt u+ 

Start nop 
nop 

_lab move.b (a0)+,(al)+ 
bne.s _lab 

ende 

bra.s _lab ; bezieht sich NICHT auf das obige "_lab n 

Sollten Sie sowohl den Punkt als auch den Unterstrich für einen normalen Symbolnamen 
benötigen, dann können Sie durch die Direktive »OPT U-« bewirken, daß nur noch 
die Zahlenlabel der Form »xxx$« als lokale Symbole gültig sind. 
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3.4 Ausdrücke 

3.4.1 Symbolsyntax und Konstanten 

Ein nicht lokales Symbol (siehe oben) muß mit einem Buchstaben, Punkt oder Unter¬ 
strich beginnen. Nach dem ersten Zeichen darf zusätzlich eine Dezimalziffer im Symbol¬ 
namen Vorkommen. Es besteht der Case-Unterschied, solange nicht die »c c«-Option 
beim Aufruf benutzt wird. Als Buchstaben sind im Symbolnamen auch internationale 
Zeichen wie z.B. »ö« oder »ae« zulässig, so daß der Symbolname »Ärger« korrekt ist. 

Ein Symbol ist absolut, wenn es einem absoluten Ausdruck zugewiesen wird, z.B.: 
AbsolutesSymbol EQU 5*3 

Ein Symbol ist relativ, wenn es einem relativen Ausdruck, d.h. dem aktuellen Pro¬ 
grammzähler, zugewiesen wird. Lokale Symbole sind immer relativ. Beispiele: 


Relativ 

EQU * 

; Zuweisung an den aktuellen Programmzähler 

1$ 

nop 


rela 

nop 


nochwas 

equ rela 

; Zuweisung an relatives Symbol 


Ein Symbol gilt als importiert, wenn es durch die XREF-Direktive definiert wurde. Für 
importierte Symbole sind nur wenige Rechenoperationen möglich. 

Sie müssen also absolute, relative oder importierte Symbole unterscheiden. Durch die 
unten folgenden Rechenregeln überträgt sich diese Eigenschaft auch auf Teilausdrücke. 
Konstanten gelten immer als absolut; es gibt die folgenden Konstanten: 

1. Eine Dezimalzahl besteht nur aus Dezimalziffern, z.B. »1234«. 

2. Eine Hexadezimalzahl beginnt mit dem Dollarzeichen »$«, und es folgen hexa¬ 
dezimale Ziffern »0« bis »9« sowie die Buchstaben »a« bis »f«, z.B. »$la3F« 
für den Dezimalwert 6719. Es gibt keinen Case-Unterschied. 

3. Eine Binärzahl besteht aus einem Prozentzeichen, gefolgt von binären Ziffern 
»0« oder »1«, z.B. »%01001« für den Dezimalwert 9. 

4. Eine Oktalzahl beginnt mit dem kommerziellen »At«-Zeichen »@«, und es fol¬ 
gen oktale Ziffern »0« bis »7«, z.B. »@2347« für den Dezimalwert 1255. 

5. Eine Stringkonstante beginnt mit einem einfachen oder doppelten Hochkomma 
und endet dann auch mit dem einfachen oder doppelten Hochkomma (nicht mit 
dem jeweils anderen!). Sie darf maximal vier Zeichen lang sein und wird rechtssei¬ 
tig aufgefüllt. Der Case-Unterschied besteht hier. Soll ein einfaches bzw. doppeltes 
Hochkomma selber als Zeichen Vorkommen, müssen Sie es zweimal angeben. Dies 
ist im übrigen für alle Fälle gültig, in denen der Assembler einen String liest, z.B. 
auch für INCLUDE, DC.B, IDNT, TTL usw. Beispiele: 


’2-3 ’ 
"2-3” 


Wert: $00322D33, rechtsseitiges Auffüllen 
Wert: $00322D33, rechtsseitiges Auffüllen 
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” Wert: $00000000 

’It”s’ Wert: $49742773 

"It’s" Wert: $49742773 

"It'"'s" Wert: $49742773 

"It""s’ Fehler, hätte mit doppeltem Hochkomma enden müssen 

3.4.2 Rechenregeln 

Der Assembler wertet Ausdrücke nach hierarchischem Prinzip aus, so daß z.B. 
Punkt- vor Strichrechnung geht. Ein Teilausdruck oder Operand darf ein Symbol, 
der aktuelle Programmzähler »*« oder eine Konstante sein. Beachten Sie, daß der 
Stern »*< im Offsetabschnitt (siehe OFFSET-Direktive) nicht den relativen Pro¬ 
grammzähler, sondern den absoluten Offsetzähler repräsentiert, und daß bei ganzzahli¬ 
gen Ausdrücken keine Fließkommasymbole erlaubt sind (siehe auch unten). Bei ganz¬ 
zahligen Ausdrücken wird immer mit ganzzahligen, vorzeichenbehafteten Werten von 
32 Bit Länge gerechnet. Folgende Operatoren sind gültig: 


Priorität 

Operator 

Bedeutung 

5 

+ 

Monadisches Plus 

5 

- 

Monadisches Minus 

5 


Logisches Negat (Tildezeichen) 

4 

>> 

Rechtsverschieben (zweimal ">") 

4 

<< 

Linksverschieben (zweimal "<") 

3 


Logisches Exklusiv-Oder ("Dach") 

3 

& 

Logisches Und 

3 

1 

Logisches Oder 

3 


Logisches Oder 

2 

* 

Multiplikation 

2 

/ 

Division 

2 

% 

Modulo-Operator 

1 

+ 

Addition 

1 

- 

Subtraktion 


Operatoren mit höherer Priorität werden zuerst berechnet. Die Priorität kann durch 
Klammerung durchbrochen werden, wobei die Klammerverschachtelung zusammen mit 
der Operatorverschachtelung bis zu 32 Ebenen tief reicht. Die Operatoren mit der 
Priorität fünf sind monadische Operatoren, haben also nur einen Operanden, der un¬ 
mittelbar auf den Operator folgt. 

Alle Operatoren mit Priorität größer eins können nur mit absoluten Werten oder Sym¬ 
bolen als Operanden arbeiten. Das Ergebnis ist immer ein absoluter Wert. Das mona¬ 
dische Plus akzeptiert als einzige Ausnahme alle möglichen Operanden. 

Für die Addition sind folgende Kombinationen von absoluten, relativen und impor¬ 
tierten Operanden gültig (z.B. ergibt absoluter Operand plus relativer Operand einen 
relativen Wert bzw. evtl, neuen Operanden): 
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Addition 

absolut relativ importiert 

absolut 

relativ 

importiert 

absolut relativ importiert 

relativ FEHLER FEHLER 

importiert FEHLER FEHLER 


Für die Subtraktion sind folgende Kombinationen gültig (z.B. ergibt relativ minus 
relativ einen absoluten Wert oder absolut minus relativ einen Fehler): 


Subtraktion 

absolut relativ importiert 

absolut 

relativ 

importiert 

absolut FEHLER FEHLER 

relativ absolut FEHLER 

importiert FEHLER FEHLER 


Nun noch ein paar Beispielausdrücke: 

3+4*5 ergibt 23 absolut 

’2’+start ergibt $34 relativ, wenn M >start"< den Wert 2 relativ hat 

"2’ ergibt einen Fehler, korrekt ist "2" oder ’ 2’ 

♦-Start ergibt 4 absolut, wenn ">start"< den Wert 2 relativ hat 

und der Programmzähler (immer relativ) den Wert 6 
~t ergibt $FFFFFFFE = -2 

(8»2) Acht, zweimal nach rechts geshiftet (ergibt 2 absolut) 

(1«7) Eins, siebenmal nach links geshiftet (-> $80 absolut) 

(1«7)!1 ergibt $81 absolut 

(80+128)«16! (32+128)«4 ergibt $00D00A00 absolut 

3.4.3 Fließkomma-Ausdrücke 

Ausdrücke bei der FEQU- oder FSET-Direktive oder bei FPU-Befehlen mit der Größen¬ 
angabe S, D, X oder P sind Fließkomma-Ausdrücke, die immer als absolut geltende 
Fließkommasymbole enthalten dürfen. Ganzzahlige Symbole werden im Fließkomma- 
Ausdruck erst in Fließkommawerte umgewandelt; zudem sind nur absolute Werte er¬ 
laubt. Beachten Sie jedoch, daß solche Fließkomma-Ausdriicke nur verarbeitet werden 
können, wenn ihr Rechner eine FPU besitzt. Gerechnet wird dann mit Hilfe der FPU 
mit Extended-Precision-Zahlen mit 19 bis 20 Stellen Genauigkeit im Bereich 6*10 4931 
bis 9* IO -4952 . 

Als Operatoren sind nur noch Addition, Subtraktion, Multiplikation, Division und der 
Modulo-Operator erlaubt, wobei die obige Priorität weiterhin gilt. Ferner sind Fließ- 
kommazahlcn erlaubt, welche aus einem Vorzeichen, einer Dczimalziffcr oder einem 
Punkt und darauffolgenden Nachkommastellen, sowie einem evtl, ebenfalls vorzeichen¬ 
behafteten Exponenten bestehen. Leerzeichen dürfen zwischendurch nicht Vorkommen. 

Beispiele für Fließkomma-Zahlen und -Ausdrücke: 
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0.0001 

0.0001e3 ist 0.1 

3.141592653589793 

-3E-10 

-.4E20 ist -4E19 

-.4E+20 

+78 

Pi*3+Wert wobei Pi Fließkomma- und Wert Integersymbol ist 
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3.5 Adressierungsarten 

OMA unterstützt alle gängigen Adressierungsarten der Motorola-Prozessoren wie von 
Motorola definiert. Bezüglich Optimierungen sei auf das Kapitel 3.9 verwiesen. Im fol¬ 
genden bezeichnet »a« einen absoluten Ausdruck, »r< einen relativen und »d« einen 
Ausdruck, der absolut oder relativ sein kann. Für die Register des Prozessors gibt es 
keinen Case-Unterschied, d.h., es gilt 

S p s Sp = sP = SP und DO = dO 


3.5.1 Normale Adressierungsarten 

Dn 

Datenregister direkt. Für die Datenregister kann per EQUR und SETR ein Re¬ 
gistersymbol definiert werden. Beispiele: "dO" "D5" 

An 

Adressregister direkt. Für die Adreßregister kann per EQUR und SETR ein 
Registersymbol definiert werden. Beispiele: "A5" "aO M 

(An) 

Adressregister indirekt. Beispiele: "(a3)" "(AO)" 

(An) + 

Adreßregister indirekt mit Postinkrement. Beispiele: "(a3) + " M (A0) + " 

-(An) 

Adressregister indirekt mit Predekrement. Beispiele: "-(a3) M "-(AO)" 

a(An) 

Adressregister indirekt mit vorzeichenbehaftetem 16-Bit-Offset. Wenn der Offset 
Null ist, kann zu »(An)« optimiert werden. Beispiele: ”5(a3)" "5(A0) M 

a(An,Xn.x) 

Adressregister indirekt mit vorzeichenbehaftetem 8-Bit-Offset und Index. Der 
Index darf ein Daten- oder Adreßregister mit der optionalen Größenan¬ 
gabe ».w« oder ».1« sein. Beispiele: "5(a3,dO) M "5(a3,d0.w) M "5(al,aO) M 
"5(aO,a5.W) M "l(a6,d0.1) M "-45(a4,a2.L) M 

(An,Xn.x) 

Diese Schreibweise für »a(An,Xn)« ist erlaubt, wenn der Offset Null sein soll. 


a 


Absolut lang. Diese Adressierungsart kann zu »Absolut kurz« optimiert werden. 
Beispiele: "wert" "5" (würde zu »Absolut kurz« optimiert) 
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Absolut lang. Diese Schreibweise verhindert immer, daß zu »Absolut kurz« 
optimiert wird. Beachten Sie, daß Sie den Ausdruck nicht in Klammern einfassen 
müssen. Beispiele: "5.1" "5.L" "wert.l" "wert.L" 

a.W 

Absolut kurz. Der Wert »a« muß im Bereich -32768 bis 32767 liegen. Beispiele: 
"5.w" "4.W" 


Absolut lang mit 32-Bit-Relokation. Diese Adressierungsart wird evtl, zu »PC¬ 
relativ« optimiert. Beispiele: "start" "*" 

r.L 

Absolut lang mit 32-Bit-Relokation. Diese Schreibweise verhindert in jedem Fall, 
daß zu »PC-relativ« optimiert wird. Beispiele: "start.1" "start.L" 

r.W 

Absolut kurz mit 16-Bit-Relokation. Es wird ein Warning erzeugt, da 16-Bit- 
Relokationen auf dem Amiga nur in den seltensten Fällen zu lauffähigen Pro¬ 
grammen führen. Sie sollten dies nur unter ganz verrückten Umständen benöti¬ 
gen (z.B. bei ROM-Programmen). 

r (PC) 

PC-relativ mit vorzeichenbehaftetem 16-Bit-Offset. Beachten Sie, daß PC¬ 
relative Adressierung nur innerhalb derselben Sektion erlaubt ist (siehe SEC- 
TION-Direktive). Beispiele: "start(PC)" "ende(pc)" 

r(PC,Xn.x) 

PC-relativ mit vorzeichenbehaftetem 8-Bit-Offset und Index. Der Index darf ein 
Daten- oder Adreßregister mit der optionalen Größenangabe ».w« oder ».1« 
sein. Beispiele: "start(PC,dü)" "ende(pc,dü.L)" 

r(Xn.x) 

Diese verkürzte Schreibweise von »r(PC,Xn)« wird erkannt, wenn der Ausdruck 
relativ ist, und kann leicht mit »d(An)« verwechselt werden. Daher generiert 
OMA bei jeder Benutzung ein Warning, das Sie auffordert, die Schreibweise mit 
»PC« zu verwenden. Beispiele: "start(dO)" "ende(dO.L)" 

#a 

Unmittelbar absolut. Der Prozessorbefehl entscheidet, ob ein 8-, 16- oder 32-Bit- 
Wert generiert wird oder ob der unmittelbare Wert in die Prozessorinstruktion 
eingebettet wird. Beispiele: "#5" "#wert" 

#r 

Unmittelbar mit Relokation. Der Prozessorbefehl bestimmt, ob ein 8-, 16- oder 
32-Bit-Wert generiert wird. Beispiele: "#*" "#start." 


3.5.2 Adressierungen ab MC68020 

Bitte beachten Sie, daß die Adressierungsarten ab MC68020 erst erreichbar sind, wenn 
Sie per MC68020-Direktive oder einer ähnlichen einen Prozessor ab MC68020 aus¬ 
gewählt haben. 

Bei Indexregistern »Xn« gibt es nun auch das Scaling, bei dem der Inhalt es Index¬ 
registers vor Verwendung mit 1, 2, 4 oder 8 multipliziert wird, z.B. »D5.W*4«. Zur 
Optimierung wird immer die kürzeste Adressierung verwandt, wenn möglich. Dies läßt 
sich durch Ausschalten des Optimierers verhindern. 

(bd,An,Xn) 

Adressregister indirekt mit Index und Base-Displacement. Diese Adressierungs¬ 
art arbeitet wie »a(An,Xn)«, nur kann das Base-Displacement »bd« hier bis 
zu 32 Bit groß sein oder fehlen, und das evtl, mit Scaling versehene Indexregister 
darf ebenfalls fehlen. Hier wird ggbf. zu »(An)« oder >a(An,Xn)< optimiert, 
»bd« darf absolut oder relativ sein und ist vorzeichenbehaftet. Beachten Sie, 
daß hierdurch auch z.B. »(Dn)« erlaubt ist, d.h. Datenregister indirekt, oder 
»()«, was Adresse 0 anspricht. 

(bd,PC,Xn) 

PC-relativ mit Index und Base-Displacement. Das oben Gesagte gilt auch hier, 
bezieht sich jedoch auf die PC-relativen Adressierungen. Hier wird ggbf. zu 
»r(PC)< oder »r(PC,Xn)« optimiert. 

( [bd,An],Xn,od) 

Speicher indirekt post-indexed. Auch hier dürfen die einzelnen Bestandteile weg¬ 
gelassen werden, z.B. spricht »([])« die Adresse an, deren Zeiger in Adresse 0 
steht. Das Outer-Displacement muß relativ oder importiert sein. 

([bd,An,Xn],od) 

Speicher indirekt pre-indexed. Hier wird die Indirektion erst nach der Indizierung 
durchgeführt. 

([bd,PC],Xn,od) 

PC-relativ Speicher indirekt post-indexed. Hier wird »bd« als PC-relativ ange¬ 
sehen und statt eines Adreßregisters der aktuelle PC addiert. 

([bd,PC,Xn],od) 

PC-relativ Speicher indirekt pre-indexed. Hier wird die Indirektion erst nach der 
Indizierung durchgeführt. 

Bei den PC-relativen Modi ist zudem auch der String »ZPC« statt »PC« erlaubt. 
In dem Fall wird der PC nicht hinzuaddiert, die resultierende Adresse ist also absolut, 
und die Function-Code-Leitungen des Prozessors sind beim Zugriff auf Program-Space 
geschaltet. Dies werden Sie in der Regel nicht benötigen. 
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3.5.3 Spezialregister 

Es gibt noch implizite Adressierungsarten, die ein Spezialregister des Prozessors, der 
PMMU öder FPU ansprechen: 

Für die MPU: 

SP Stackpointer 
SR Status-Register 

CCR Condition-Code-Register, die unteren 8 Bit des Statusregisters 
USP User-Stackpointer (im Supervisor-Mode) 

VBR Vector-Base-Register (ab MC68010) 

SFC Source-Function-Code (ab MC68010) 

DFC Destination-Function-Code (ab MC68010) 

CACR Cache-Control-Register (ab MC68020) 

CAAR Cache-Address-Register (nur MC68020 und MC68030) 

MSP Master-Stackpointer (ab MC68020) 

ISP Interrupt-Stackpointer (ab MC68020) 

Für die PMMU (MC68851 oder ab MC68030; MC68040 hat andere PMMU-Kodierung): 

SRP Supervisor-Root-Pointer 
CRP CPU-Root-Pointer 

URP User-Root-Pointer nur für MC68040, Synonym für CRP 

TC Translation-Control-Register. Dieser Name kollidiert bei 1.3-Includefiles mit ei¬ 
nem gleichen Namen in »exec/tasks.i«, ändern Sie daher fremde 1.3- Includefiles 
ab, indem Sie dort an »TC’< einen Unterstrich hängen. Das dortige Symbol wird 
ohnehin nie verwendet und sorgt nur für einen Redefinitionsfehler. Bei den mit¬ 
gelieferten 1.3-Includefiles ist diese Modifikation bereits durchgeführt. 

MMUSR PMMU-Statusregister 

PSR Synonym für MMUSR (wurde für MC68851 benutzt) 

TTO Transparent-Translation-Register 0 (nur MC68030) 

TT1 Transparent-Translation-Register 1 (nur MC68030) 

DTTO Data-Transparent-Translation-Register 0 (ab MC68040) 

DTTl Data-Transparent-Translation-Register 1 (ab MC68040) 

ITTO Instruction-Transparent-Translation-Register 0 (ab MC68040) 

ITT1 Instruction-Transparent-Translation-Register 1 (ab MC68040) 

Für die FPU (MC68881, MC68882 oder ab MC68040): 

FPSR FPU-Statusregister 
FPCR FPU-Control-Register 
FPIAR FPU-Instruction-Address-Register 
FPn Fließkommaregister FPO bis FP7 


3.5.4 Adressierungs-Schablonen 

Es folgt eine Zusammenfassung aller Adressierungsart-Formen, die erkannt werden: 


Dn 

An 

-(An) 

dl6(An) 

(d32,An) 

d8(An,Xn) 

(dl6,An,Xn) 

(d32,An,Xn) 

(d32,Xn) 

(Xn) 

(r8,PC) 

(rl6,PC) 

(r8,PC,Xn) 

(rl6,PC,Xn) 

(rl6,ZPC) 

(r32,ZPC) 

(r32,ZPC,Xn) 

a 

r 

r. 1 

#a 

#r 

(□) 

( □ ,od) 

([An]) 

([An],od) 

([Xn]) 

([Xn],od) 

([bd]) 

([bd],od) 

([bd,An]) 

([bd,An],od) 

([bd,Xn]) 

( [bd,Xn],od) 

([bd.PC]) 

([bd,PC],od) 

( [bd,PC,Xn]) 

( [bd,PC,Xn],od) 

([bd.ZPC],Xn) 

([bd.ZPC],Xn,od) 


(An) 

(An) + 

(d8,An) 

(dl6,An) 

(An,Xn) 

(d8,An,Xn) 

(d8,Xn) 

(dl6,Xn) 

0 

r16(PC) 

(r32,PC) 

r8(PC,Xn) 

(r32,PC,Xn) 

(r8,ZPC) 

(r8,ZPC,Xn) 

(rl6,ZPC,Xn) 

a.l 

a. w 

r. w 

r8(Xn) 

(D.Xn) 

( [] , Xn, od) 

([An],Xn) 

([An],Xn,od) 

([An,Xn]) 

( [An,Xn],od) 

([bd],Xn) 

( [bd],Xn,od) 

([bd,An],Xn) 

([bd,An],Xn,od) 

([bd,An,Xn]) 

( [bd,An,Xn],od) 

([bd.PC],Xn) 

([bd.PC],Xn,od) 

([bd.ZPC]) 

([bd.ZPC],od) 

( [bd,ZPC,Xn] ) 

([bd,ZPC,Xn],od) 
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3.6 Die Direktiven 

Als Opcode erkennt der Assembler alle Instruktionen der Motorola-68000-Familie sowie 
Makros (siehe Unterkapitel 3.6.6 über Makros) und Direktiven. Zusätzlich existiert der 
ILLEGAL-Opcode, der die Kodierung $4AFC erzeugt. Direktiven und Instruktionen 
des Prozessors erkennt OMA ohne Case-Unterschied. 

Bei den Prozessorinstruktionen prüft der Assembler, ob der Befehl auf eine gerade 
Adresse kommen wird, da sonst eine Adreß-Exception des Prozessors ausgelöst würde. 
Sollte dies der Fall sein, meldet der Assembler ein Warning und legt den Befehl auf eine 
gerade Adresse, d.h., der Programmzähler wird gerade gemacht. Achten Sie in dem Fall 
darauf, daß ein evtl, in der vorigen Zeile einzeln definiertes Symbol ungerade ist; ein 
Ansprung der Instruktion würde auf einer ungeraden Adresse landen! 

OMA assembliert immer relokatiblen Code, d.h., es ist egal, wo das fertige Programm 
im Speicher zu liegen kommt. Daher ist der Programmzähler auch relativ, denn er gibt 
den Offset zum Programmstart an. 

Direktiven sind Pseudobefehle des Assemblers, die genau wie Prozessorinstruktionen 
ausselien, jedoch ganz bestimmte Steuerungsaufgaben innerhalb des Assemblers ha¬ 
ben. Im folgenden werden die einzelnen Direktiven nach Gruppen geordnet beschrie¬ 
ben. Für manche Direktiven gibt es Synonyme, die statt der üblichen Direktive auch 
verwandt werden können und Quelltextkompatibilität zu anderen Assemblern gewähr¬ 
leisten. Wenn Sie neue Quelltexte verfassen, sollten Sie aber die eigentlich vorgesehene 
Direktive verwenden. Ein Labelfeld ist für eine Direktive nur erlaubt, wenn es in der 
Formatschablone explizit angegeben ist. Ist Label nicht in eckige Klammern eingefaßt, 
dann muß ein Labelfeld vorhanden sein. 


3.6.1 Steuerungsdirektiven 


MC68000 

MC68010 

MC68020 

MC68030 

MC68040 

MC68881 

MC68882 

Diese Direktiven wählen den passenden Prozessortyp oder schalten die FPU-Befehle ein. 
Es wird immer getestet, ob der gerade zu verarbeitende Befehl oder ein Register für den 
eingeschalteten Prozessor zulässig ist, z.B. gibt es einen Fehler, wenn Sie die MC68Ü10 
gewählt haben und die PACK-Instruktion assemblieren oder das CACR ansprechen 
möchten. Sie dürfen zu geringeren und höheren Stufen schalten, aber sobald einmal 
angewählt, können die FPU-Befehle immer verarbeitet werden; sie lassen sich danach 
nicht wieder abschalten. 
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Beachten Sie, daß Sie zum Assemblieren von Fließkomma-Ausdrücken eine FPU in 
Ihrem Rechner besitzen müssen, da OMA diese mit Hilfe der FPU auswertet. 

Möchten Sie PMMU-Befehle benutzen, sollten Sie eine MPU ab MC68030 auswählen. 
Beachten Sie dabei aber, daß z.B. MC68030 und MC68040 völlig inkompatible PMMU- 
Befehle besitzen. 


CPID n 

Da es mehrere Coprozessoren in einem Motorola-68000-System geben kann, können Sie 
mit dieser Direktive die Coprozessor-ID für FPU-Befehle verändern. »n« ist die neue 
Nummer, muß absolut sein, im Bereich von 0 bis 7 liegen und ist voreingestellt auf den 
Wert eins, d.h., es wird die normale FPU-ID angenommen. 

In der Regel brauchen Sie dies nur, wenn Sie mehrere FPUs in einem System haben 
und diese parallel arbeiten lassen wollen. Bis jetzt ist ein solcher Fall noch auf keinem 
Amiga aufgetreten. 


[Label] SECTION Name[,Typ][,Speichertyp] 

Bitte lesen Sie in diesem, Zusammenhang auch das Kapitel S.S über den Beginn einer 
Sektion. Der Assembler schreibt die erzeugten Daten in Sektionen, d.h. Sammeleinhei- 
ten für Daten. Daten in unterschiedlichen Sektionen sind funktionsmäßig getrennt und 
gelangen auch in getrennter Weise in das Objektfile. Es gibt drei Arten von Sektio¬ 
nen: Code (sollte immer Prozessor befehle bekommen), Data (hier sollten Konstanten 
und Variablen mit Anfangswerten hineinkominen) und Bss (speichert Variablen ohne 
Initialwert und ist im Objektfile sehr kurz, da nur die Sektionslänge vermerkt ist). 
Es ist immer eine Sektion eingeschaltet; der Assembler beginnt mit einer namenlo¬ 
sen Code-Sektion und dem Programmzählerwert Null. Mit SECTION können Sie nun 
zwischen Sektionen hin- und herschalten. SECTION schaltet auf die Sektion mit dem 
Namen »Name« oder erzeugt sie, wenn sie nicht existiert. Es wird ab der letzten 
Programmzähler-Einstellung weiterassembliert. Label wird nach dem Umschalten dem 
neuen Programmzähler zugewiesen. Für Name gelten die üblichen Stringregeln. 

Typ ist der Sektionstyp, erlaubt ist CODE, DATA oder BSS (kein Case-Unterschied). 
Wenn der Typ fehlt, wird eine Code-Sektion definiert. Speichertyp definiert, in welche 
Speicherbereiche des Amiga diese Sektion geladen werden kann. Erlaubt ist PUBLIC, 
CHIP oder FAST. Alternativ kann für »CODE,CHIP« bzw. »CODE,FAST« auch 
»CODE-C« bzw. »CODE_F« benutzt werden, analog auch DATA_C, DATA_F, BSS_C 
und BSS_F. 

Möglich sind bis zu 255 Sektionen pro Assemblerlauf; falls die gewünschte Sektion 
bereits existiert und bei SECTION der Sektionstyp und evtl, der Speichertyp angegeben 
ist, müssen diese beiden mit der ersten Definition dieser Sektion übereinstimmen, sonst 
erfolgt eine Fehlermeldung. 
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[Label] CODE 

Diese Direktive arbeitet wie SECTION, schaltet aber auf die namenlose Code-Sektion 
mit dem Speichertyp PUBLIC. Label wird nach dem Umschalten zugewiesen. 


[Label] DATA 

Diese Direktive arbeitet wie SECTION, schaltet aber auf die namenlose Data-Sektion 
mit dem Speichertyp PUBLIC. Label wird nach dem Umschalten zugewiesen. 


[Label] BSS 

Diese Direktive arbeitet wie SECTION, schaltet aber auf die namenlose Bss-Sektion 
mit dem Speichertyp PUBLIC. Label wird nach dem Umschalten zugewiesen. 


[Label] RORG Absolutausdruck 

Der Programmzähler wird auf Absolutausdruck gesetzt. Label wird nach dem Umschal- 
ten zugewiesen. 

Absolutausdruck darf nicht negativ oder kleiner als der Programmzähler sein. Diese In¬ 
kompatibilität zum Metacomco-Assembler ist aber kein Hindernis, da beim Rücksetzen 
des Programmzählers die alten, schon erzeugten Daten und Instruktionen durch die 
neuen überschrieben würden. Ein Rücksetzen des Programmzählers ist daher ohnehin 
sinnlos. Sollte der neue Programmzähler hinter dem alten liegen, wird der Zwischen¬ 
raum durch Nullbytes aufgefüllt. 

Synonym: RORIGIN. 


ORG Absolutausdruck 

Dieser Befehl wird nicht unterstützt und bewirkt eine Fehlermeldung. Für das Erzeugen 
absoluter EPROM-Programme sei auf das Hilfsprogramm Absolute verwiesen. Nachteil: 
Die Adressierungsart »Absolut kurz« wird nicht in allen Fällen automatisch als Op¬ 
timierung verwendet. Dies sollte aber nicht ins Gewicht fallen, da beim Amiga diese 
Adreßbereiche ohnehin nicht für EPROMs geeignet sind. 

Synonym: ORIGIN, ABSOLUTE. 
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[Label] CNOP Offsetausdruck,Basisausdruck 

Der Programmzähler kann mit CNOP auf eine beliebige Grenze gelegt werden. Er wird 
auf die nächste Grenze der Basisnummer plus dem Offset gesetzt. Offsetausdruck und 
Basisausdruck müssen absolut und ohne Vorwärtsreferenz sein. Label wird nach dem 
Umschalten zugewiesen. Beispiele: 

CNOP 0,4 legt den Programmzähler auf die nächste Langwortgrenze 

CNOP 0,2 legt den Programmzähler auf die nächste Wortgrenze 

Der Programmzähler sei 6. Bei "CNOP 3,4" ist 8 die nächste Langwortgrenze und 
8+3=11 die Adresse mit dem Offset. Da aber 11-4=7 noch hinter 6 liegt, wird der neue 
Programmzähler 7 sein! 

Der freie Raum zwischen neuem und altem Programmzähler wird mit Nullbytes auf¬ 
gefüllt. In einem OFFSET-Abschnitt (siehe unten) wird der Offsetzähler statt des Pro¬ 
grammzählers geändert. 


[Label] EVEN 

Der Programmzähler wird auf die nächste gerade Adresse gesetzt. Label wird nach dem 
Umschalten zugewiesen. Der freie Raum zwischen neuem und altem Programmzähler 
wird mit Nullbytes aufgefüllt. 

In einem OFFSET-Abschnitt (siehe unten) wird der Offsetzähler statt des Pro¬ 
grammzählers geändert. 


BASEREG Adreßregister 

Mit BASEREG kann der Basereg-Modus ein- oder ausgeschaltet werden. Wenn der 
String Adreßregister der String »OFF« (kein Case-Unterschied) ist, wird der Modus 
ausgeschaltet. 

Der Basereg-Modus ermöglicht es, in einem Programm, das nur aus einem einzigen 
Quelltext besteht, die verkürzte »a(An)«-Adressierungsart aus »Absolut Lang« zu 
erzeugen, sofern die Adresse in einer Bss-Sektion liegt. Dazu sollte nur eine Bss-Sektion 
definiert und ein Adreßregister als Basiszeiger reserviert werden. Der Basiszeiger muß 
die Adresse »Bss-Sektion-Start + 32768« enthalten! 

Die Werte der Bss-Sektion müssen vor ihrer Benutzung bekannt sein, sonst kann der 
Assembler die Adressierungsart nicht konvertieren (oder es muß der Mehrpass-Modus 
eingeschaltet werden). Ein Beispiel: 
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CODE 

lea Basis+32768,a4 
BASEREG a4 


schalte auf namenlose Code-Sektion 
initialisiere Basisregister richtig und 
aktiviere die Code-Sektion als erste 
schalte Basereg-Modus ein 


BSS 

Basis 

wertl ds.l 1 
wert2 ds.l 1 


schalte auf namenlose Bss-Sektion 
erste Adresse der Bss-Sektion 
wertl = 0 relativ 
wert2 = 4 relativ 


CODE 

move d0,wert2 
clr wertl 


schalte auf Code-Sektion zurück 
wird als "MOVE DO,-$7FFC(A4)" direkt 
hinter obiges "lea" assembliert 
wird als "CLR -$8000(A4)" assembliert 


BASEREG off ; schaltet den Basereg-Modus wieder aus 


Die Code-Sektion muß vor der Bss-Sektion angesprochen werden, da sonst die Bss- 
Sektion als erster Hunk im Objektfile steht und die Ausführung des Programmes in 
ihr beginnen würde (siehe Kapitel 3.8)! Mit dieser Adressierung kann eine Bss-Sektion 
von maximal 64 KByte Größe adressiert werden. Variablen über dieser Grenze werden 
immer »Absolut Lang< assembliert. 

Der Linker erfährt von diesem Modus nichts; eine Veränderung des Basisregisters durch 
z.B. »move.l d0,a4« während des Basereg-Modus führt zu einem Warning. 


[Label] END 

Beendet den laufenden Assembler-Pass und ignoriert alle im Quellfile folgenden Zeilen. 
Label wird vor dem Beenden zugewiesen. END darf nicht in einem Includefile Vorkom¬ 
men (siehe INCLUDE-Direktive), und jeder Quelltext sollte mit END enden, da sonst 
ein Warning generiert wird. 

Synonym: ENDSRC. 


INCLUDE Filename 

Der Assembler unterbricht die Assemblierung des aktuellen Quellfiles und schiebt das 
Includefile Filename in den Assemblerlauf ein. Wenn dieses neue File zu Ende ist, wird 
im alten Quellhle fortgefahren. Mit INCLUDE werden z.B. Konstanten für den Amiga 
aus dem Include-Directory gelesen. Es wird zuerst im aktuellen Directory nach dem 
File gesucht, dann in den beim Assembleraufruf mit der >-i<-Option angegebenen Di¬ 
rectories, dann in den INCDIR-Directories (siehe folgende Direktive) sowie im evtl. 
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vorhandenen Default-Includedirectory AINC: (siehe auch >-i<-Startoption). Für File¬ 
namegelten die üblichen Stringregeln. Sie dürfen Includehles beliebig tief verseil achteln. 

Bitte beachten Sie, daß Sie durch Vorassemblieren von Includehles Zeit sparen können. 
Siehe Kapitel 3.13. 

Synonym: GET. 

INCDIR Name[,Name]... 

Diese Direktive fügt der Liste der Directories zum Suchen von Includehles neue Namen 
hinzu. Für Name gelten die üblichen Stringregeln. Bitte beachten Sie, daß das Default- 
Includedirectory AINC: hinter den mit INCDIR definierten Directories in der Liste steht, 
falls es existiert. Das heißt, daß es dann nach den INCDIR-Namen nach Includehles 
durchsucht wird. 


[Label] INCBIN Filename[,Byteanzahl] 

Der Assembler weist Label als relatives Symbol dem Programmzähler zu und liest aus 
dem File Filename maximal Byteanzahl Binärbytes. Wenn Byteanzahl fehlt, werden alle 
Bytes des Files eingelesen. Es erfolgt keine Meldung, wenn weniger als Byteanzahl By¬ 
tes gelesen wurden. Filename gehorcht den üblichen Stringregeln und muß vollständig 
vorhanden sein, da die Include-Directory-Liste hier nicht benutzt wird. 

Synonym: IBYTES. 


[Label] INCPRE Filename 

INCPRE inkludiert ein vorassembliertes File genau wie die Startoption »-p<, kann al¬ 
lerdings mehrfach verwendet werden. Damit können mehrere unabhängige, vorassemb- 
lierte Files in den Assemblerlauf einbezogen werden bzw. man kann sich die Startoption 
sparen. Die Symbole in den vorassemblierten Files dürfen nicht andere redehnieren, und 
der Assembler ist ebenso empfindlich gegenüber falschen Files wie bei der Startoption. 
Für Filename gelten die üblichen Stringregeln. Ein Label ist erlaubt. Siehe auch das 
Kapitel über vorassemblierte Includehles. 


OUTPUT Name 

Mittels OUTPUT können Sie die Namensgebung für das Objekthle beeinflussen. Name 
darf mit einem Punkt beginnen, in dem Fall zählt Name als Suffix für den Objekth- 
lenamen. Wenn schon mittels »-o«-Option ein Name angegeben wurde, bekommt das 
Objekthle diesen Namen. Sonst gelten die folgenden Regeln: 
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• Ist Name kein Suffix, bekommt das Objektfile den Namen Name. 

• Ist Name ein Suffix, bekommt das Objektfile den Namen, der sich aus dem Quell¬ 
filenamen ohne evtl. »,asm«-Suffix, aber mit Name als Suffix zusammensetzt. 

Wurde weder die >-o<-Option noch OUTPUT benutzt, dann gilt: 

• Ist das Programm direkt ausführbar, erhält es den Namen, der sich aus dem 
Quellfilenamen ohne evtl. >.asm«-Suffix zusammensetzt. 

• Ist das Objektfile nur linkbar, bekommt es den Namen, der sich aus dem Quell¬ 
filenamen ohne evtl. >.asm«-Suffix, aber mit ».obj« als Suffix zusammensetzt. 


OPT Option[,Option]... 

OPT ermöglicht die Auswahl mehrerer Optionen. Jede Option beginnt mit einem Buch¬ 
staben, gefolgt von »+« oder »-«. Es gibt folgende Optionen: 

C+ Es wird der Case-Unterschied gemacht. Mit C- wird nicht unterschieden. Diese 
Option darf mehrfach Vorkommen und hat Priorität vor der >-c c«-Startoption. 

D+ Relative Symbole werden ins Objektfile in einen Symbolhunk geschrieben. Diese 
Option entspricht der >-c s«-Startoption, ist aber wirkungslos, falls diese ver¬ 
wandt wurde. D- verhindert die Symbolhunkproduktion. Die letzte Einstellung 
ist gültig. 

L+ bestimmt, daß ein linkbares Objektfile erzeugt wird. L- bestimmt, daß ein 
ausführbares Programm erzeugt wird. Bei XREF/XDEF wird dann ein Fehler 
erzeugt. Bitte beachten Sie, daß diese Option auf der allerersten Zeile stehen muß 
und daß OMA selber zwischen ausführbar und linkbar entscheidet (anhand von 
Vorkommen/Fehlen von XREF/XDEF), falls die Option nicht benutzt wird. 

M+ entspricht etwa MLIST, M- entspricht etwa NOMLIST. Der Unterschied besteht 
darin, daß die >-c m«-Startoption Vorrang vor M+ und M- hat, aber MLIST 
und NOMLIST Vorrang vor der Startoption. 

o+ schaltet den Optimierer ein, O- schaltet ihn aus. Es ist nicht möglich, einzelne 
Optimierungsstufen ein- bzw. auszuschalten. Die Option hat Priorität gegenüber 
der »-c o<-Startoption. Siehe auch OPTIMIZE/NOOPTIM-Direktiven. 

P+ bewirkt, daß in jeder Zeile mit einer Relokation ein Fehler erzeugt wird, was 
Sie zum Erstellen von positionsunabhängigen, d.h. vollständig PC-relativen Pro¬ 
grammen benutzen können. P- schaltet diesen Modus wieder aus. 

S+ listet nach dem Listing die Symboltabelle ins Listingfile, S- verhindert dies. Die 
»-c t«-Startoption hat Vorrang vor dieser Option. Die jeweils letzte Einstellung 
ist gültig. 

U+ Die speziellen lokalen Label werden ab sofort mit einem Unterstrich >_« statt 
mit einem Punkt >.« eingeleitet. Mit U- werden die speziellen lokalen Label 
ausgeschaltet, d.h., nur noch Label der Form »1$«, >45$« usw. gelten als lokal. 
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W+ schaltet das Ausgeben von Warnings an, W- schaltet es aus. Die >-c w«- 
Startoption hat Vorrang vor dieser Option. 

X+ Es werden nur exportierte, relative Symbole in einen Symbolhunk geschrieben. 
Die »D+«-Option und die >-c s«-Startopt,ion haben Vorrang, bei ihnen wer¬ 
den alle relativen Symbole geschrieben, auch wenn X+ eingeschaltet wurde. X- 
schaltet den Modus aus. Die jeweils letzte Einstellung ist gültig. 


[Label] REPT Anzahl 
(Befehle) 

ENDR 

Mit diesen Direktiven fassen Sie mehrere Befehle zusammen und wiederholen diesen 
Block Anrra/z/mal. Anzahl muß absolut und ohne Vorwärtsreferenz sowie größer als Null 
sein. Die Direktiven REPT und ENDR sind nicht in Makros erlaubt, ebenso darf bei 
den Befehlen keine Makroaufnahme Vorkommen, aber eine Makroexpansion ist erlaubt. 
Beispiel zum Erzeugen von zehn NOPs: 

REPT 10 

nop 

ENDR 


OPTIMIZE 

Der Optimierer wird eingeschaltet. Diese Direktive kann die Aufrufoption >-c o« un¬ 
wirksam machen. Siehe Kapitel 3.9. 

Synonym: OPT 0+. 

N00PTIM 

Der Optimierer wird wieder ausgeschaltet. Siehe Kapitel 3.9. 

Synonym: OPT O-, 

N00BJ 

Diese Direktive hat dieselbe Wirkung wie die Option >-c n«. Die Produktion des 
Objektfiles wird unterdrückt. 
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FAIL 

Meldet einen benutzererzeugten Fehler in der aktuellen Zeile. Diese Direktive wird im 
allgemeinen benutzt, um auf Fehler in Makros hinzuweisen. Siehe Unterkapitel 3.6.6. 


MASK2 

FORMAT 

NOFORMAT 

COMMENT 

SUBTTL 

Diese Direktiven werden akzeptiert, haben aber keine Wirkung und werden nur aus 
Kompatibilitätsgründen zu anderen Assemblern verstanden. 


3.6.2 Zuweisungsdirektiven 


Label EQU Ausdruck 

Es wird ein Symbol namens Label mit dem Wert Ausdruck definiert. Der Ausdruck darf 
keine Vorwärtsreferenzen haben (d.h. Symbole benutzen, die in einer späteren Zeile 
definiert werden) und kann relativ, absolut oder importiert sein. Das neue Symbol darf 
noch nicht existieren. 

Synonym: EQU ATE und das Gleichheitszeichen >=<. 


Label SET Ausdruck 

Diese Direktive arbeitet wie EQU, nur kann das Symbol mit SET redefiniert. werden, 
d.h. einen neuen Wert bekommen. Ein SET-Symbol darf nicht vor seiner Definition 
verwendet werden oder schon durch ein EQU definiert sein. Siehe auch Ünterkapitel 
3.6.6 über Makros. 

Folgende Assembler-Symbole sind reserviert und können nicht redefiniert werden (kein 
O ase- U nterschied): 

DO Dl D2 D3 D4 D5 D6 D7 AO Al A2 A3 A4 A5 A6 A7 

FPO FP1 FP2 FP3 FP4 FPS FP6 FP7 PC SP SR CCR USP VBR SFC DFC 

CACR CAAR MSP ISP SRP CRP URP TC TTO TT1 DTTO DTT1 ITTO ITT1 PSR 

FPCR FPSR NARG _RS MMUSR FPIAR MACRO MEXIT ENDM ENDMAC 
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Synonym: SETVAL. 


Label FEQU[.s] FließkommaAusdruck 

Es wird ein Fließkommasymbol namens Label mit dem Wert Ausdruck definiert. Als 
Size-Specifier ist S, D, X, P oder keiner zugelassen, dieser hat jedoch keine Auswir¬ 
kung, da der Wertebereich immer Extended-Precision ist. Der Ausdruck darf keine 
Vorwärtsreferenzen haben und ist ein Fließkomma-Ausdruck, darf also andere Fließ¬ 
kommasymbole enthalten. Das neue Symbol darf noch nicht existieren. Fließkomma¬ 
symbole können z.B. in der folgenden Form verwendet werden: 

mc68882 ; oder mc68881; schalte erst FPU ein 

Pi FEQU 3.14159265358979323846 ; definiere Pi 

fmove.x #Pi,fp2 ; normaler Gebrauch 

fmul.w #3*Pi,fp2 ; multipliziere mit dreifachem Pi 


Label FSET[.s] FließkommaAusdruck 

Diese Direktive arbeitet wie FEQU, nur kann das Symbol mit FSET redefiniert werden. 
Ein FSET-Symbol darf nicht vor seiner Definition verwendet werden oder schon durch 
ein FEQU definiert sein. Für die Liste der nicht redefinierbaren Symbolnamen siehe 
SET. 


Label EQUR Register 

Es wird ein Registersymbol namens Label für das Register Register definiert. Register 
darf DO bis D7 oder AO bis A7 sein. Ein Registersymbol kann im Quelltext ohne Case- 
Unterschied überall dort verwandt werden, wo ein Daten- oder Adreßregister verlangt 
wird. Es darf aber nicht vor seiner Definition angesprochen werden. 


Label SETR Register 

Diese Direktive arbeitet wie EQUR, nur kann das Symbol mit SETR redefiniert wer¬ 
den, d.h. ein neues Register repräsentieren. Ein SETR-Symbol darf nicht vor seiner 
Definition verwendet werden oder schon durch ein EQUR definiert sein. Für die Liste 
der nicht redefinierbaren Symbolnamen siehe SET. 
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Label REG Registermaske 


XREF Label[,Label]... 


Der Assembler definiert das Symbol namens Label als Registermaske fiir den Gebrauch 
mit der Prozessorinstruktion MOVEM. Registermaske hat die Syntax 

Dn[-Dn] [/Dn] [/An] [-An] 

Beispiel d()-d3/d7/a0-a4: Die Maske besteht aus den Registern DO, Dl, D2, D3, D7, 
A0, Al, A2 und A4. Dies ließe sich auch als d0-d3/d7-a4 schreiben. 

Weitere Beispiele: a0/a2 aO/dO a0/a2-a3/d5-d7 

Als Registermaske ist auch ein Symbol erlaubt, das mit einer vorherigen REG-Direktive 
deklariert wurde. 

Synonym: EQURL. 


Label SETREG Registermaske 

Diese Direktive arbeitet wie REG, nur kann das Symbol mit SETREG redefiniert wer¬ 
den. Ein SETREG-Symbol darf nicht vor seiner Definition verwendet werden oder schon 
durch ein REG definiert sein. Für die Liste der nicht redefinierbaren Symbolnamen siehe 
SET. 

Synonym: SETRL. 


IDNT String 

Ein Objektfile enthält einen Unitnamen, der bis zur Verwendung dieser Direktive leer 
ist. Der neue Name ist String und gehorcht den üblichen Stringregeln. 

Synonym: IDENTIFY. 


XDEF Label[,Label]... 


XREF definiert importierte Symbole, die relativ oder absolut sein können, und ver¬ 
merkt, daß das Objektfile linkbar sein wird und nicht direkt ausführbar. Wie oben 
erwähnt, können damit Referenzen auf andere Objektfiles vereinbart werden. 

Falls »OPT L-« eingeschaltet ist, wird bei dieser Direktive ein Fehler erzeugt. 

Synonym: IMPORT (besonders empfohlen), EXTRN, EXTERN. 

XREF und XDEF werden verwendet, um große Programme zu inodularisieren. Sie de¬ 
klarieren z.B. in einem Modul A (d.h. in einem Textfile, vielleicht mit dem Namen 
textl.asm) eine Routine namens »KopiereString«. Wenn Sie in diesem Modul A den 
Befehl »XDEF KopiereString« geben, dann macht der Assembler diesen Namen für 
andere Module sichtbar. Sie benötigen jetzt z.B. in einem Modul B (d.h. in einem Text¬ 
file namens z.B. bearbeite.asm) genau diese Routine »KopiereString« und können nun 
diese Routine aus Modul A verwenden, indem Sie »XREF KopiereString« befehlen. 
Der Assembler assembliert jetzt zwar nicht erneut eine Routine »KopiereString«, aber 
er vermerkt, daß diese Routine aus Modul A in Modul B benutzt wurde. Die beiden 
Objektfiles textl.obj und bearbeite.obj, die der Assembler erzeugt hat, müssen mit dem 
Linker zu einem Programm zusammengelinkt werden, wobei der Linker die Referenz 
in B auf »KopiereString« aus A auflöst. Beachten Sie, daß der Assembler bei Fehlen 
von XREF meldet, er kenne kein Symbol »KopiereString«, während er das Fehlen von 
XDEF nicht bemerken kann. Fehlt aber XDEF, dann wird der Linker melden, daß er 
die Referenz nicht lösen kann, da er »KopiereString« nicht sieht (denn es wurde nicht 
sichtbar gemacht). 

EXPORT bzw. IMPORT sind Synonyme für XDEF bzw. XREF und sollten statt die¬ 
sen verwendet werden, da sie aussagekräftiger sind und den gleichnamigen Modula-2- 
Befehlen entsprechen. 


[Label] 

DC[.size] 

[Label] 

DC.S 

[Label] 

DC.D 

[Label] 

DC.X 

[Label] 

DC.P 


Ausdruck [,Ausdruck]... 

FließkontmaAusdruck[,FließkommaAusdruck] . .. 
FließkommaAusdruck[,FließkommaAusdruck]... 
FließkommaAusdruck[,FließkommaAusdruck]... 
FließkommaAusdruck[,FließkommaAusdruck]... 


XDEF macht relative oder absolute Symbole für andere Objektfiles sichtbar und ver¬ 
merkt, daß das Objektfile linkbar sein wird und nicht direkt ausführbar. Andere Ob¬ 
jektfiles können sich durch XREF auf durch XDEF extern sichtbar gemachte Symbole 
beziehen. Der Linker hat die Aufgabe, diese Referenzen aufzulösen. Für eine genauere 
Beschreibung zum Benutzen der beiden Direktiven siehe XREF unten. 

Falls »OPT L-« eingeschaltet ist, wird bei dieser Direktive ein Fehler erzeugt. 

Synonym: EXPORT (besonders empfohlen), ENTRY. 


Der Assembler weist Label als relatives Symbol dem Programmzähler zu und speichert 
Ausdrücke. Abhängig von size werden Bytes, Worte oder Langworte gespeichert. Mit 
den übrigen Größenangaben können Sie auch Fließkommakonstanten unterschiedlicher 
Genauigkeit in den Code einfügen. 

Falls es die Bytegröße ist, ist als Ausdruck noch eine Folge von Zeichen erlaubt, die 
in einfache oder doppelte Hochkommata eingefaßt ist und als String gespeichert wird. 
Soll dann das Hochkomma selber als Zeichen erscheinen, muß es zweimal angegeben 
werden. Beispiele: 



102 _ KAPITEL 3. OPTIMIERENDER MAKRO-ASSEMBLER V2.1 


de .b 

’ Dies 

ist 

ein String’,0 


de .b 

"Dies 

ist 

ein String",0 


de .b 

'Dies 

ist 

’ ’n String’,0 


de .b 

"Dies 

ist 

’n String",0 


de .b 

'Dies 

ist 

’n String’,0 

(falsches Deutsch) 

de .b 

"Dies 

ist 

' "n String",0 

(falsches Deutsch) 


Bei Bytegröße darf der Ausdruck nicht relativ sein; ist es keine Bytegröße, dann wird der 
Programmzähler noch vor der Labelzuweisung gerade gemacht, um Adreß-Exceptions 
des Prozessors MC68000 oder MC68010 zu verhindern. 

Synonyme: DB—DC.B, DW=DC.W, DL—DC.L, DD—DC.D, DX=DC.X, DP=DC.P. 


[Label] DCB[.size] Absolutausdruck,Ausdruck 

[Label] DCB.S Absolutausdruck,FließkommaAusdruck 

[Label] DCB.D Absolutausdruck,FließkommaAusdruck 

[Label] DCB.X Absolutausdruck,FließkommaAusdruck 

[Label] DCB.P Absolutausdruck,FließkommaAusdruck 

Ist es keine Bytegröße, so wird der Programmzähler gerade gemacht. Danach wird Label 

als relatives Symbol dem Programmzähler zugewiesen und ein Block von Absolutaus¬ 
druck mal dem Ausdruck erzeugt. Abhängig von size werden Bytes, Worte oder Lang¬ 
worte gespeichert. Bei Bytegröße darf der Ausdruck nicht relativ sein. Mit den übrigen 
Größenangaben können Sie auch Blöcke von Fließkommakonstanten unterschiedlicher 
Genauigkeit in den Code einfügen. Beispiel: 


dcb.w 4,2 entspricht dc.w 2,2,2,2 

dcb.s 4,3.14 entspricht dc.s 3.14,3.14,3.14,3.14 


Synonym: BLK. 

[Label] 

DS [ .size] 

Absolutausdruck 

[Label] 

DS.S 

Abs o lut ausdruc k 

[Label] 

DS.D 

Absolut ausdruc k 

[Label] 

DS.X 

Absolut ausdruck 

[Label] 

DS.P 

Absolutausdruck 


Diese Direktive wird zum Reservieren von Speicher oder zum Zuweisen von Konstanten 
im Offsetabschnitt gebraucht. 

Falls KEIN Offset-Abschnitt eingeschaltet ist: 

Ist es keine Bytegröße, wird der Programmzähler erst einmal gerade gemacht. 
Label wird als relatives Symbol dem Programmzähler zugewiesexr. Danach stellt 
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der Assembler den Programmzähler um Absolutausdruck Bytes, Worte, Lang¬ 
worte oder um die Größe der Fließkommazahl weiter. Der Zwischenraum wird 
mit Nullbytes gefüllt. 

Falls ein Offset-Abschnitt eingeschaltet ist: 

Ist es keine Bytegröße, wird der Programmzähler erst einmal gerade gemacht. 
Label wird als absolutes (!) Symbol dem Offsetzähler zugewiesen und der Off¬ 
setzähler um Absolutausdruck Bytes, Worte, Langworte oder um die Größe der 
Fließkommazahl weitergestellt. Siehe OFFSET-Direktive. 

Synonym: RESERVE. 


RSRESET 

RSSET Absolutausdruck 

[Label] RS[.size] Absolutausdruck 

[Label] RS.S Absolutausdruck 

[Label] RS.D Absolutausdruck 

[Label] RS.X Absolutausdruck 

[Label] RS.P Absolutausdruck 

Mit diesen drei Direktiven ist es möglich, fortlaufend absolute Werte wie mit EQU 
zuzuweisen. Es wird ein interner Zähler mitgeführt: 


rsreset 
a rs.1 1 

b rs. w 1 
rsset 6 
c rs 0 


setze Zähler auf Null 

weise a=0 zu und stelle Zähler um 4 (Langwort) weiter 
weise b=4 zu und stelle Zähler um 2 (ein Wort) weiter 
setze Zähler auf sechs 

weise c=4 zu und stelle Zähler um 0 Worte weiter 
(bleibt also unverändert) 


Bitte beachten Sie, daß der Zähler vor der Zuweisung gerade gemacht wird, wenn ist 
nicht Bytegröße ist. 

Die RS-Direktiven sind komfortabler als die Verwendung von OFFSET (siehe folgend), 
und das reservierte Symbol __RS (es sind zwei Unterstriche) enthält immer den aktuellen 
Wert des RS-Zählers. Betrachten Sie auch die Includefiles, dort wird von RS ausgiebig 
Gebrauch gemacht. 


OFFSET Absolutausdruck 

Der Assembler beginnt einen Offsetabschnitt zum Zuweisen von Oftsets ähnlich wie mit 
den RS-Direktiven. Der Offsetzähler wird auf Absolutausdruck gesetzt. Beispiel: 
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OFFSET 0 
a ds.1 1 

b ds.w 1 
RORG * 


beginne Offsetabschnitt mit Zähler=0 

weise a=0 zu und stelle Zähler um 4 (Langwort) weiter 
weise b=4 zu und stelle Zähler um 2 (ein Wort) weiter 
beende den Offsetabschnitt 


Der Offsetabschnitt muß mit RORG, ORG, OFFSET, SECTION, CODE, DATA, BSS 
oder END beendet werden. In einem Offsetabschnitt, sind keine codeproduzierenden 
Direktiven erlaubt, damit die DS-Direktive eindeutig entweder einem Offsetabschnitt 
oder einer Sektion zugeordnet werden kann. 

Diese Direktive existiert aus Kompatibilitätsgründen, bitte benutzen Sie die RS- 
Direktiven. 


; Eingabe: A5: Seif. 

METHODBODY Rechteck_Initialize 
PROC 

SMETHOD a5,ClassRechteck,Rechteck_Initialize ; erst Oberklasse 
move #1,rechteck_Höhe(a5) ; jetzt Höhe auf 1 

move #1,rechteck_Breite(a5) ; und Breite auch 

ENDPROC 


Nach der SMETHOD-Direktive ist das Register A6 verändert! Die objektorientierte 
Programmierung mit OMA wird ausführlich im Kapitel 7 behandelt. Dort wird auch 
gezeigt, wie mit Hilfe eines Makros namens SUPER die Angabe der aktuellen Klasse 
automatisiert werden kann. 


3.6.3 Objektorientierte Direktiven 


[Label] METHOD Objekt.MethodenID 

Mit dieser Direktive wird eine Methode eines Objekts aufgerufen. Objekt darf dabei jede 
Adressierungsart sein (z.B. A5) und ist der Zeiger auf das Objekt. Methoden ID ist eine 
Methoden-ID, deklariert mit Hilfe der mitgelieferten Makros im Includefile ooma.i. ME¬ 
THOD darf im Gegensatz zu SMETHOD an beliebigen Stellen im Programm auftreten. 
Beispiel: 

; A5 zeige auf Objekt "Benji" der Klasse "Hund" 

METHOD a5,Hund_Belle 
METHOD tom,Katze_AufDenBaum 

tom ds.l 1 ; Zeiger auf Objekt der Klasse "Katze" 

Nach der METHOD-Direktive ist das Register A6 verändert !Die objektorientierte Pro¬ 
grammierung mit OMA wird ausführlich im Kapitel 7 behandelt. 


[Label] SMETHOD Objekt,AktuelleKlasse,MethodenID 

Diese Direktive ruft eine Methode eines Objektes auf, allerdings wird die Methodenim 
plementierung der Oberklasse angesprungen. SMETHOD wird nur in Methodenimple¬ 
mentierungen von Klassen verwendet und erlaubt es, die Funktionalität der Oberklasse 
zu erreichen. Ein einfacher METHOD-Aufruf würde nämlich nur die Methode dersel¬ 
ben Klassenebene aufrufen, und dies führte zu einer Rekursion, wenn die aufrufende 
Methode den gleichen Namen hat. Beispiel: 


3.6.4 Listingdirektiven 

Für die folgenden Direktiven sollten Sie auch das Kapitel 3.12 über das Listinghle lesen. 


PAGE 

Gibt einen Seitenvorschub ins Listinghle und schaltet den Seitenvorschub wieder ein. 
Die Direktive erscheint selber nicht im Listing. 

Synonym: PAGEUP. 


NOPAGE 

Schaltet den Seitenvorschub aus und erscheint selber nicht im Listing. 


SPC Nummer 

Gibt Nummer Leerzeilen ins Listing und erscheint selber nicht im Listing. Nummer 
muß eine Dezimalzahl im Bereich 1 bis 250 sein. 

Sofern der Seitenvorschub eingeschaltet ist, wird er bei den mit SPC erzeugten Zeilen 
weiterhin ausgelöst. 


LLEN Nummer 
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Die Zeilenlänge des Listings wird auf Nummer Zeichen eingestellt. Damit wird jede 
Listingzeile spätestens nach dem Nummer ten Zeichen beendet. Die Direktive darf nur 
einmal pro Assemblerlauf Vorkommen und erscheint nicht im Listing. Nummer muß 
eine Dezimalzahl im Bereich 60 bis 300 sein. Der Wert 132 ist voreingestellt . 


NOCLIST 

Schaltet das Listen von Zeilen innerhalb von Abschnitten der bedingten Assemblierung 
mit Falsch-Wert aus. Siehe auch IF-Direktiven. 


PLEN Nummer 

Die Seitenlänge des Listings wird auf Nummer Zeilen eingestellt. Damit wird alle Num¬ 
mer Zeilen ein Seitenvorschub ins Listing gegeben, wenn dieser nicht durch NOPAGE 
ausgeschaltet ist. Die Direktive darf nur einmal pro Assemblerlauf Vorkommen und er¬ 
scheint nicht im Listing. Nummer muß eine Dezimalzahl im Bereich 24 bis 100 sein. 
Der Wert 60 ist voreingestellt. 


TTL Titel 

Setzt den Titel im Seitenvorschub des Listings auf Titel und sollte nur einmal pro 
Assemblerlauf Vorkommen. Dieser Titel ist vorerst immer leer. Für Titel gelten die 
üblichen Stringregeln. 

Synonym: TITLE. 


LIST 

Schaltet das Listen von Zeilen ein und erscheint selber nicht im Listing. 


NOLIST 

Schaltet das Listen von Zeilen aus und erscheint selber nicht im Listing. Sie können 
also verhindern, daß bestimmte Abschnitte ins Listing gelangen. 

Synonym: NOL 


CLIST 


Schaltet das Listen von Zeilen innerhalb von Abschnitten der bedingten Assemblierung 
mit Falsch-Wert ein. Dieser Wert ist vor eingestellt. Siehe auch IF-Direktiven. 


MLIST 


Schaltet das Listen von Zeilen während der Makroexpansion ein. Dieser Wert ist vor¬ 
eingestellt. Siehe auch 3.6.6. 


NOMLIST 


Schaltet das Listen von Zeilen während der Makroexpansion aus. Siehe auch 3.6.6. 


LISTCHAR Ausdruck[.Ausdruck]... 

Schreibt ein oder mehrere Steuerzeichen mit dem ASCII-Wert Ausdruck in das Listing- 
file, sofern dieses nicht auf das Terminal geht. Ausdruck muß Bytegröße haben und 
absolut und positiv sein. 


3.6.5 Bedingte Assemblierung 

Die bedingte Assemblierung ermöglicht es, abhängig von einem Wahrheitswert einer IF- 
Direkt.ive Quelltext-Teile von der Assemblierung auszuschließen oder sie einzubeziehen. 
IF-Direktiven können beliebig tief verschachtelt werden. Zwei Beispiele: 

a) 


if eq 0 
nop 

if eq 1 
rts 
ende 
ende 


wahr, da 0=0 
wird assembliert 
falsch, da 1 ungleich 0 
wird daher nicht assembliert 
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ifne 0 
nop 

ifne 1 
rts 
ende 
ende 


falsch, da 0 nicht ungleich 0 
wird daher nicht assembliert 
wahr, da 1 ungleich 0 

würde assembliert, aber die äußere Schleife.. 
..ist falsch, also ist der Wahrheitswert der.. 
..inneren Schleife egal 


Für die bedingte Assemblierung existieren die folgenden Direktiven: 


IFC Stringl,String2 

Liefert Wahr, wenn Stringl und String2 identisch sind. Für die Strings gelten der Case- 
Unterschied und die üblichen Stringregeln. 


IFNC Stringl,String2 

Liefert Wahr, wenn die beiden Strings nicht identisch sind. 


IFD Symbol 

Liefert Wahr, wenn das Symbol vor dieser Zeile definiert wurde. 


IFND Symbol 

Liefert Wahr, wenn das Symbol nicht vor der Zeile definiert wurde. 

IFEGJ Absolut ausdruck 
Liefert Wahr, wenn Absolutausdruck gleich Null ist. 

IFNE Absolutausdruck 

Liefert Wahr, wenn Absolutausdruck ungleich Null ist. 
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IFGT Absolutausdruck 

Liefert Wahr, wenn Absolutausdruck größer als Null ist. 

IFLT Absolutausdruck 

Liefert Wahr, wenn Absolutausdruck kleiner als Null ist. 

IFGE Absolutausdruck 

Liefert Wahr, wenn Absolutausdruck größer oder gleich Null ist. 

IFLE Absolutausdruck 

Liefert Wahr, wenn Absolutausdruck kleiner oder gleich Null ist. 

ELSE 

ELSE kehrt den Wahrheitswert der letzten IF-Direktive um. Beispiel: 

IFD DEBUG 

... ; Teil, der assembliert wird, wenn DEBUG definiert ist 

ELSE 

... ; Teil, der assembliert wird, wenn DEBUG NICHT definiert 

ENDC ; beende die bedingte Assemblierung 

Synonym: ELSEIF. 

ENDC 

ENDC beendet einen Abschnitt einer IF-Direktive. Falls es noch höhere IF-Direktiven- 
Verschachtelungen gibt, wird die bedingte Assemblierung aber fortgeführt, z.B. 

IFEQ wert ; Stelle 1 

IFNE zahl ; Stelle 2 

ENDC ; beendet IF von Stelle 2 

ENDC ; beendet IF von Stelle 1 


Synonym: ENDIF. 
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3.6.6 Makros 


3.6.7 Makro-Parameter, -Spezialbefehle und -Beispiele 


Makros sind Zusammenfassungen mehrerer Quelltextzeilen, die nach ihrer Definition 
auf Abruf in die Assemblierung cingeschoben werden. Sie können mit Parametern ver 
sehen werden, so daß Sie wiederkehrende Sequenzen von Quellzeilen nur einmal ange¬ 
geben müssen, auch wenn diese geringfügige Unterschiede aufweisen. Ein Makro wird 
aufgerufen, indem sein Name als Opcode im Opcodefeld der Zeile steht. 

Makros können beliebig tief geschachtelt werden und sich selber rekursiv aufrufen. Es 
gibt die folgenden Direktiven für sie: 


Label MACRO 


Der Assembler definiert Label als Makrosymbol und beginnt die Makroaufnahme. La¬ 
bel kann Assemblerdirektiven redefinieren, die Erkennung eines Makroaufrufes ist aber 
im Gegensatz zu den Direktiven abhängig von der Groß- und Kleinschreibung, so daß 
z.B. RTS immer noch als Prozessorbefehl erkannt wird, wenn ein Makrosymbol namens 
»Rts« existiert. Normalerweise prüft OMA bei einem Opcode zuerst, ob es eine Di¬ 
rektive ist, und dann, ob es ein Makro ist. Sobald Sie eine Direktive redefiniert haben, 
arbeitet der Assembler aber prinzipbedingt langsamer! Ab dem Zeitpunkt wird nämlich 
zuerst geprüft, ob der Opcode ein Makro ist. Für die Liste der nicht redefinierbaren 
Symbolnamen siehe SET-Direktive. 

Innerhalb der Makroaufnahme kann keine erneute Makroaufnahme erfolgen; die Ver¬ 
schachtelung von MACRO-Direktiven ist also unzulässig. 


ENDM 


ENDM beendet die aktuelle Makroaufnahme. Der Makro kann von nun an aufgerufen 
werden. Nach ENDM kann auch eine Aufnahme für einen anderen Makro gestartet 
werden. 

Synonym: ENDMAC. 


MEXIT 


MEXIT unterbricht die Makroexpansion der momentanen Hierarchie-Stufe der Ma¬ 
kroverschachtelung. Der Assembler sorgt auch dafür, daß die evtl, im Makro benutzte 
IF-Verschachtelung auf den Stand vor der Expansion dieses Makros gebracht wird. 


Wenn einem Makro Parameter mitgegeben werden, stehen sie wie bei Direktiven im 
Operandenfeld. Die Parameter werden als String in die Makroexpansion gebracht und 
können Leerzeichen enthalten, wenn der betreffende Parameter in spitze Klammern 
><< und »>« oder in eckige >[< und »]< eingefaßt ist. Brauchen Sie »>« oder 
>]< selber in einem Parameter, können Sie den Parameter entweder mit der jeweils 
anderen Klammer einfassen oder das Zeichen doppelt angeben (»>X, »]]«), sofern 
der Parameter schon mit der entsprechenden Klammer eingefaßt wurde. 

Im Makro werden die Parameter mit der Kombination Backslash-Zahl bzw. -Buchstabe 
angesprochen. »\1« bis »\9< bezeichnet also die Parameter eins bis neun und »\a< 
bzw. »\A< bis »\z« bzw. »\Z< die Parameter zehn bis fünfunddreißig. Wollen Sie 
den Backslash selber in der expandierten Zeile erscheinen lassen, geben Sie ihn einfach 
doppelt an: »\\< erzeugt »\«. 

Das Spezialsymbol NARG (kein Case-Unterschied) enthält für jeden aufgerufenen Ma¬ 
kro die Anzahl der ihm mitgegebenen Parameter (auch Leerstrings werden mitgezählt). 

Es folgen einige Makrobeispiele: 


a) 


CALL macro 
IFEQ NARG-2 
move.l \2,a6 
ENDC 

IFLE NARG-2 

jsr _LV0\l(a6) 
MEXIT 
ENDC 

FAIL CALL Makrofehler 
endm 


zwei Parameter? 

ja, dann zweiten Parameter nach A6 laden 

zwei oder kein Parameter? 
dann rufe Systemlibrary auf 
und beende Expansion 

; Fehler, wenn mehr als zwei Parameter 


Der Aufruf CALL Delay expandiert zu jsr _LV0Delay(a6). Der Aufruf CALL 
Wait ,_SysBase expandiert zu 


move.l _SysBase,a6 
jsr _LV0Wait(a6) 

Der Aufruf CALL expandiert zu jsr _LV0(a6) und erzeugt höchstwahrscheinlich einen 
Fehler. Der Aufruf 

CALL 1,2,3 


expandiert zu 
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move.1 2,a6 

jsr _LV01(a6) (höchstwahrscheinlich mit Fehler) 

FAIL CALL Makrofehler (da mehr als zwei Parameter) 

Der dritte Parameter wird überhaupt, nicht verwendet. 

b) 

STRING macro 

de .b ’\1\0 
endm 

Der Aufruf STRING <Dies ist ein String> oder STRING [Dies ist ein String] 
expandiert zu 

dc.b 'Dies ist ein String’,0 


c) 

ERZEUGE macro 
wert SET \1 
IFNE wert 
dc.b 0 

ERZEUGE wert-1 
ENDC 
endm 

Dieser Makro ruft sich selber rekursiv auf und erzeugt soviele Nullbytes wie im Para¬ 
meter des ersten Aufrufes angegeben! 

Der Aufruf ERZEUGE 3 expandiert zu 

dc.b 0 
dc.b 0 
dc.b 0 

»wert« wird deswegen jedesmal mit SET dem Parameterwert zugewiesen, damit durch 
den rekursiven Aufruf »\1-1« statt »wcrt-1« nicht eine überlange Quellzeile expan¬ 
diert würde (z.B. »300-1-1-1-1-1-1-1...« usw.). »ERZEUGE« kann wegen der belie¬ 
big tiefen Makro- und IF-Verschachtelung beliebig viele Nullbytes erzeugen. ERZEUGE 
100000 könnte nur an der Speichergröße scheitern. Dieser Makro ist ein etwas akade¬ 
misches Beispiel; Sie können das gleiche Resultat einfacher erreichen, indem Sie DCB 
oder die REPT-Direktive verwenden (siehe auch dort), z.B.: 


schon Null erreicht? 

nein, noch ein Nullbyte erzeugen 

und uns selber rekursiv aufrufen 
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rept 3 
dc.b 0 
endr 


<i) 

Multistring macro 

ifne ; ist String nichtleer? 

dc.b ’\1’,0 ; ja, dann erzeuge ihn 

Multistring \2,\3,\4,\5,\6,\7,\8,\9 
ende 
endm 

Der Makro kann bis zu zehn Strings in einem Rutsch erzeugen (rekursiver Aufruf). 
Er bricht ab, sobald der erste Leerstring erscheint, was spätestens nach dem zehnten 
String der Fall ist, da nicht angegebene Parameter zu Leerstrings expandiert werden. 
Der Aufruf 

Multistring <Der erste>,[der zweite]»EinerOhneLeerzeichen 

expandiert zu 

dc.b ’Der erste’,0 

dc.b ’der zweite’,0 

dc.b ’EinerOhneLeerzeichen’,0 

e) 

Der Parameter \0 hat eine besondere Stellung. Er wird durch die dem Makroaufruf 
mitgegebene Größenangabe (B, W, L, S, D, X oder P) ersetzt. 

Push macro 

move.\0 \1,-(SP) 
endm 

Dieser Makro schiebt die angegebenen Werte auf den Stack. Der Aufruf Push.w dO 
expandiert zu 

move.w d0,-(SP) 

Der Aufruf Push.L a4 expandiert zu 
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move.L a4,-(SP) 

Der Aufruf Push dO expandiert zum fehlerhaften 
move. dO,-(SP) 

Also muß unser Makro etwas komplizierter werden: 

Push macro 

ifc ’’,’\0 ’ 

move \1,-(SP) 

eise 

move.\0 \1,-(SP) 

ende 
endm 


f) 

Der Parameter \@ (Backslash - Kommerzielles At) wird durch eine Zahl ersetzt, die 
angibt, wie oft bereits Makros expandiert wurden. Diese Zahl ist also für jeden expan¬ 
dierten Makro einzigartig und kann zum Definieren von unverwechselbaren Symbolen 
verwendet werden. Vor sie wird automatisch ein Unterstrich gesetzt, damit die Label¬ 
syntax korrekt ist, wenn \@ am Zeilenanfang steht. 

BSTRING macro 

de.b ende\@-*-l ; ergibt die Länge des Strings 
de.b ’\1> 

ende\@ 

endm 

Dieser Makro definiert einen BCPL-String, der nicht mit einem Nullbyte endet, sondern 
in seinem ersten Byte die Länge des Strings enthält. Wenn es die 45. Expansion ist, 
dann expandieren die beiden Zeilen 

BSTRING <Beispiel> 

BSTRING Beispiel 

beide identisch zu der Sequenz 

dc.b ende_45-*-l (Differenz ende_45 zum Stringbegirm ist 8) 
dc.b ’Beispiel’ 
ende_45 


; wenn \0 Leerstring ist 
; sonst 
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Der Assembler kennt ferner noch einige Spezial-Makrobefehle, die die Möglichkeiten 
der Textverarbeitung bei einer Makroexpansion ganz erheblich erweitern. Diese Be¬ 
fehle werden wie Parameter durch Zeichenfolgen ersetzt, und es besteht kein Case- 
Unterschied. 

\*VALGF(Symbol) 

wird durch den Dezimalstring des Symbolwertes von Symbol ersetzt: 
\*valof (wert) ergibt 65, wenn wei t den Wert 65 hat. 

\*LEFT(Text,n) 

ergibt die n linken Zeichen des Strings Text: \*left(Eiffelturm,6) ergibt 
Eiffel. 

\*RIGHT(Text,n) 

ergibt die n rechten Zeichen des Strings Text: \*right(Eiffelturm,4) ergibt 
türm. 

\*MID(Text,n,m) 

ergibt die m Zeichen ab der Position n im String Text: 

\*mid(Donaudampfschiffahrt,6,5) ergibt dampf. 

\*STRLEN(Text) 

wird durch den Dezimalstring der Stringlänge von Text ersetzt. 
\*strlen(Assembler) ergibt 9. 

Diese Spezialbefehle dürfen nur innerhalb von Makros verwendet werden und können 
rekursiv geschachtelt werden, wobei Sie jedoch beachten sollten, daß der Stack ausrei¬ 
chend groß ist, da für jede Verschachtelung 512 Bytes benötigt werden. Beispiele für 
Rekursion sind: 

\*VALOF(\*LEFT(MeinSymbol,4)) expandiert zu 
\*VALOF(Mein) und zum Dezimalstring 

65 wenn ">Hein"< den Wert 65 hat 


Es soll ein Makro definiert werden, der prüft, ob der mitgegebene Parameter mit 
»Donau< beginnt, und sonst einen Fehler erzeugt: 

PRÜFE macro ; nationale Zeichen sind als Label zulässig! 

IFNE NARG-1 ; ein Parameter? 

FAIL falsche Parameter 
ENDC 

IFNC ’\*left(\l,5)’,’Donau’ ; korrekter Beginn? 

FAIL falscher Beginn 
ENDC 
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Der Aufruf PRÜFE Donaudampf schiff ahrt erzeugt keine Fehlermeldung. Der Aufruf 
PRÜFE Editor erzeugt die Fehlermeldung »FAIL falscher Beginn«. Der Aufruf PRÜFE 
erzeugt »FAIL falsche Parameter« und »FAIL falscher Beginn«. 

h) 

Sie möchten (maximal drei) Zeichen im Bereich von »A« bis »Z« jeweils in 5 Bit 
kodieren und folgendermaßen in ein 16-Bit-Speicherwort packen: ‘/.Oaaaaabbbbbccccc. 
Dabei ist »aaaaa« der erste Buchstabe usw. Sie benutzen: 

QUETSCH MACRO 

zeichenl SET "\*MID(\1,1,1)"-"A M ; schneide Zeichen aus String 
zeichen2 SET "\*M1D(\1 , 2,1) M -"A" ; das Ergebnis der Zuweisungen 
zeichen3 SET M \*MID(\1,3,1)"-"A" ; ist eine Zahl von 0 bis 25 

dc.w (zeichenl«10)I(zeichen2<<5)|zeichen3 
ENDM 


i) 

Die folgenden Makros könnten benutzt werden, um einfach und schnell Menüs unter 
Intuition zu definieren. Beachten Sie dabei, daß der Text nach der MACRO-Direktive 
als Kommentar angesehen wird und nur der Erläuterung eines Lesers der Makros dient: 

MENU MACRO NextMenu,LeftEdge,Width,Firstitem,Name 
de.1 \1 

dc.w \2,0,\3,11,MENUENABLED 
de.1 1$,\4 

dc.w 0,0,0,0 
1$ de .b ’\5\0 

CNOP 0,2 
ENDM 

ITEXT MACRO Text 

de.b 0,1,RP_JAM1 
dc.w 2,1 
de.1 0,2$,0 

2$ dc.b ’\1’,0 

CNOP 0,2 
ENDM 

ITEM MACRO NextItem,TopEdge,MutualExclude,Flags,Key,ItemText 
de.1 \1 

dc.w 0,\2,BREITE,ITEM.HOEHE 

de.w \4+ITEMTEXT+ITEMENABLED+HIGHC0MP 

de.1 \3 
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de. 1 1$,0 

dc.b \5 
de. 1 0 

dc.w 0 

1$ ITEXT <\6> 
ENDM 


Sie finden im Examples-Directory der Originaldiskette weitere Beispiele für Makros, 
insbesondere beim Quelltext der Library OMA.lib. Auch im Kapitel über die objektori- 
enterte Programmierung? mit OMA wird intensiv von Makros Gebrauch gemacht, um 
Übersicht zu erzeugen und Fehler zu vermeiden. 
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3,7 Konvertierung anderer Quelltexte, Inkom¬ 
patibilitäten 

OMA ist durch seine vielen Synonyme und seine umfangreiche Makrounterstützung 
in der Lage, Quelltexte anderer Assembler ohne größere Änderungen zu assemblieren. 
Das bekannte Programm Oktalyzer wurde z.B. in nur einer halben Stunde auf OMA 
umgesetzt. 

Ein Beispiel: Bei dem Public-Domain-Assembler Asm68k gibt es Direktiven namens 
CSTRING und PSTRING. CSTRING erzeugt einen String mit einem angehängten 
Nullbyte und PSTRING erzeugt einen String ohne Nullbyte am Ende, aber mit der 
Stringlänge als erstem Byte. Die Simulationsmakros können in einem Includefile ge¬ 
lassen werden, das z.B. durch die >-h«-Option beim Assembleraufruf angegeben wird 
(dann muß der Quelltext nicht geändert werden). Die Makros lauten: 

CSTRING macro 

de.b ’\1’,0 
endm 

PSTRING macro 

dc.b ende\@-*-l,’\1’ 

ende\@ 

endm 

Wegen OM As Devpac- und Metacomco-Kompatibilität können deren Quelltexte (bei¬ 
nahe) direkt übernommen werden. Die genauen Unterschiede sind: 

3.7.1 Inkompatibilitäten zum Metacomco-Assembler Ver¬ 
sion 11.00 

• Der RORG-Ausdrnck darf bei OMA nicht kleiner als der Programmzähler sein. 
Der Metacomco akzeptiert dies, vergißt aber, zwischenzeitlich erzeugte Reloka,- 
tionen u.ä. wieder rückgängig zu machen, und erzeugt u.U. für dieselbe Stelle 
mehrere Relokationen u.ä. 

• ASL <ea> und die übrigen Speicher-Shift-Befehle assembliert OMA nicht mit den 
Größenangaben B und L, da Speicher-Shifts immer auf 16 Bit Breite erfolgen. 
Der Metacomco akzeptiert B und L. 

• Metacomco akzeptiert einen relativen Ausdruck für MOVEQ, OMA aber nicht. 

• Metacomco expandiert für den \@-Makroparameter die Form .nnn mit einem 
einleitenden Punkt, OMA aber jnnn mit einem einleitenden Unterstrich, da der 
Punkt am Anfang eines Labels normalerweise ein lokales Label einleitet. 
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3.7.2 Inkompatibilitäten zum Devpac-Assembler Version 
2, Oktober 1988 

• Die Aufrufsyntax des Devpac ist völlig anders. 

• Die reservierten Symbol __LK und __G2 existieren nicht, da OMA nicht der 
Devpac-Assembler ist! 

• Die Operatoren »—«, »<< und »>« existieren nicht, und hat bei OMA 

die gleiche Priorität wie monadisches Plus bzw. Minus. 

• RO bis R15 werden NICHT als Synonyme für DO bis D7 und AO bis A7 erkannt. 

Dies widerspräche dem Motorola-Standard. Brauchen Sie das trotzdem, definie¬ 
ren Sie die Registersymbole einfach per EQUR. 

• \W und \L werden NICHT als Synonyme für .W und .L zur Erzwingung der 
Adressierungsarten »Absolut-Lange bzw. »-Kurze erkannt. Diese Syntax wi¬ 
derspricht dem Motorola-Standard. 

• Der unmittelbare MOVEQ-Wert darf nicht im Bereich 128-255 liegen. Wollen Sie 
trotzdem eine solche vorzeichenlose Byte-Konstante »xxe laden, benutzen Sie 
MOVEQ ffxx-256,Dn. Beachten Sie aber, daß dann die Bits 8-31 des Datenregisters 
gesetzt sind. 

• ORG, IIF und XREF.L existieren nicht. 

• COMMENT, FORMAT und SUBTTL haben keine Wirkung. 

• LIST bei OMA kennt die Parameter »+« und »-< nicht. 

• LLEN darf bei OMA minimal 60 sein, Devpac geht herunter bis 38. 

• INCBIN legt bei OMA die Bytes nicht automatisch auf Wortgrenze und füllt 
nach dem Inkludieren nicht auf Wortgrenze auf. 

Bei der OPT-Direktive gibt es erhebliche Unterschiede. Im folgenden wird zuerst die 

Devpac-Konvention erläutert, dann kommen die Verhältnisse unter OMA. 

• A: Automatische PC-relativ-Konvertierung, A+ an, A- aus (default). Bei Bei 
OMA unzulässig, da defaultmäßig immer optimiert wird. 

• C: Case-Unterschied, C-f kein Unterschied, C- Unterschied (default). Zusätzlich 
kann gleich nach dem C dezimal angegeben werden, wieviele Stellen von Sym¬ 
bolen signifikant sind. Bei OMA ist die Signifikanz immer 255 Zeichen, C+ und 
C- werden aber verstanden und entsprechen der »-c c«-Option. Allerdings ist 
Devpacs C+ (kein Unterschied) bei OMA C-, und OMAs C+ schaltet die Unter¬ 
scheidung an. 

• L: Linkbares Objektfile, L+ an, L- ausführbar (default). Bei Nichtbenutzung 
dieser Option entscheidet OMA selber zwischen ausführbar und linkbar. Ferner 
meldet OMA Fehler bei der XREF/XDEF-Direktive, wenn L- gewählt wurde. 

• M: Makroexpansion im Listing, M+ an, M- aus (default). Bei OMA ist M-|- 
vor eingestellt. 
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• O: Optimierungen (defaultmäßig aus), Ol Short Brauches, 02 0(An)- 
Optimierung, 0+ alles an, O- alles aus, OW Warnings beim Optimieren an/aus. 
Da OMA defaultmäßig immer optimiert, gibt es Ol, 02, OW nicht. O+/O- enC 
sprechen OPTIMIZE/NOOPTIM. 

• S: Symboltabelle im Listing, S-f- an (default), S- aus. Bei OMA ist S- voreinge¬ 
stellt. 

• T: Typprüfung, T-f an (default), T- aus. Bei OMA unzulässig, der Typ wird 
immer geprüft. 

• X: Es gelangen nur exportierte Symbole in die Debug-Information. X+ an, X- 
aus (default). Bei OMA nur gültig, falls nicht >-c s< üiid nicht »OPT D+< 
verwendet wurden. 

Makros: 

• Wenn kein Size Specifier angegeben ist, entspricht der Parameter \0 bei OMA 
dem Leerstring und nicht tf. 

• Die Spezialkonversion »\<symbol>< bzw, »\$<symbol>< existiert nicht. Für 
»\<symbol>< kennt OMA den speziellen Makrobefehl \*VAL0F. 

• Ein Makroaufruf über mehrere Zeilen ist unzulässig. 

• Makronamen können mit anderen Symbolen kollidieren. 


3,8. BEGINN EINER SEKTION 
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3.8 Beginn einer Sektion 

Zu Beginn eines Assemblerlaufes ist die namenlose Code-Sektion eingeschaltet. Die 
Reihenfolge der Sektionen im Objektfile hängt aber nicht von der Reihenfolge der ein¬ 
geschalteten Sektionen ab, sondern von der Reihenfolge der aktivierten Sektionen. 
Deswegen kann die zuerst eingeschaltete Code-Sektion überhaupt nicht im Objektfile 
erscheinen. Die zuerst gewünschte Sektion sollte daher immer als eine der ersten Direk¬ 
tiven angegeben werden. 

Die meisten Direktiven aktivieren die gerade eingeschaltete Sektion. Die folgenden Di¬ 
rektiven aktivieren die Sektion nicht: 

IF-Direktiven, ELSE, &NDC, RS-Direktiven, ORG, SECTION, CODE, DATA, BSS, 
XDEF, XREF, OPTIMIZE, NOOPTIM, INCLUDE, INCDIR, EQU, SET, EQUR, SETR, 

REG, SETREG, FEQU, FSET, REPT, ENDE, MACRO, ENDM, MEXIT, NOOBJ, OUTPUT, 
END, OPT, LLEN, PLEN, LIST, NOLIST, CLIST, NOCLIST, MLIST, NOMLIST, 

FORMAT, NOFORMAT, PAGE, NOPAGE, TTL, SPC, MASK2, FAIL, IDNT, COMMENT, 
SUBTTL 

Darüberhinaus wird eine Sektion auch aktiviert, wenn in ihr ein relatives Symbol de¬ 
klariert wird. Beispiele: 

1. Die Data-Sektion wird als erste aktiviert, da XDEF nicht aktiviert: 

CODE 

XDEF s-ymbol 
DATA 

NOP ; aktiviert 

2. Die Code-Sektion wird trotz EQU nicht als erste aktiviert: 

CODE 

wert EQU 1 ; aktiviert nicht 

DATA 

NOP ; aktiviert 

3. Das relative Symbol aktiviert die Sektion: 

SECTION Parser,CODE 
Parserstart ; aktiviert 

4. Achtung: Hier beginnt die Programmausführung in der Bss-Sektion, da diese 
durch DS vor der Code-Sektion aktiviert wurde! Auf solche Fehler sollten Sie 
unbedingt achten! 

bss 

variable ds.w 1 
code 
nop 


; aktiviert 
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3.9 Optimierungen und Konvertierungen 

OMA trägt seinen Namen nicht umsonst, denn er optimiert effizient an allen möglichen 
Stellen, allerdings nur bei eingeschaltetem Optimierer und nur dort, wo es ohne Risiko 
möglich ist. Im Mehrpass-Modus werden auch Ausdrücke mit Vorwärtsreferenzen op¬ 
timiert, so daß auch z.B. Vorwärtssprünge in ihre Kurzform überführt werden können 
und der kürzeste Code generiert wird. 

Sie können Optimierungen verhindern (z.B. bei selbstmodifizierendem Code, den ich 
persönlich aus Kompatibilitätsgründen ablehne, weil solche Software nicht auf MC68020 
und höheren Prozessoren läuft), indem Sie z.B. »bra.w« o.ä. schreiben. Siehe auch 
Kapitel 3.5 über die Adressierungsarten. 

Folgende Optimierungen finden bei den Adressierungsarten statt: 
a(An) mit a=0 wird zu (An) optimiert. 

Absolut lang wird zu Absolut kurz oder zu PC-relativ optimiert. 

Bei den zusätzlichen Adressierungsarten der 32-Bit-Prozessoren wird die Form erzeugt, 
die den kürzesten Code ermöglicht. 

Weitere Optimierungen bzw. Konvertierungen sind: 

ADD #a,<ea> mit 1 <= a <= 8 wird zu ADDQ optimiert. 

ADD #a,<ea> mit -8 <= a <= -1 wird zu SUBQ optimiert. 

ADD wird zu ADDA bzw. ADDI konvertiert. 

ADDA #a,An mit 1 <= a <= 8 wird zu ADDQ optimiert. 

ADDA #a,An mit -8 <= a <= -1 wird zu SUBQ optimiert. 

ADDA.L #a,An mit -32768 <= a <= 32767 wird zu »ADDA.W #ä,An« op¬ 
timiert. 

ADDI #a,<ea> mit 1 <= a <= 8 wird zu ADDQ optimiert. 

ADDI #a,<ea> mit -8 <= a <= -1 wird zu SUBQ optimiert. 

AND wird zu ANDI konvertiert. 

BHS und BLO sind Synonyme von BCC und BCS. 

Branch-Befehle werden in die Kurzform optimiert. Sind sie dann Null, werden 
sie durch NOP ersetzt und bei BSR ein Fehler gemeldet (Weglassen von Null- 
branches würde im Mehrpass-Modus zum »Gummiband-Effekt« führen:-per 
Assembler macht immer wieder neue Passes und terminiert nicht). 

Ein BSR mit Nulldistanz zur folgenden Instruktion muß als BSR.W geschrieben 
werden, um einen Fehler zu verhindern. 

Ungerade Branches erzeugen ein Warning. 

CMP #a,<ea> mit a=0 wird zu TST optimiert. 

CMP wird zu CMPA, CMPI oder CMPM konvertiert. 

CMPI #a,<ea> mit a=0 wird zu TST optimiert. 

CLR.L Dn wird zu »MOVEQ #0,Dn« optimiert. 


DBHS und DBLO sind Synonyme von DBCC und DBCS. 

DBRA ist ein Synonym zu DBF. 

Ungerade Branches erzeugen ein Warning. 

Alle Divisionsbefehle mit unmittelbarem Nulloperanden melden ein Warning: 
Division durch Null. 

EOR wird zu EORI konvertiert. 

JMP wird zu BRA optimiert. 

JSR wird zu BSR optimiert. 

MOVE.x #a,<ea> mit a=0 wird zu »CLR.x <ea><, »SUB.L An,An< oder 
»MQVEQ #0,Dn« optimiert. 

MOVE.L #a,Dn mit,'-128 <= a <= 127 wird zu »MOVEQ #a,Dn« optimiert. 

MOVEA.x #a,An mit a=0 wird zu »SUBA.L An,An« optimiert. 

Alle Multiplikationsbefehle mit unmittelbarem Nulloperanden melden ein War¬ 
ning: Multiplikation ergibt Null. 

OR wird zu ORI konvertiert. 

SHS und SLO sind Synonyme von SCC und SCS. 

SUB #a,<ea> mit 1 <= a <= 8 wird zu SUBQ optimiert. 

SUB #a,<ea> mit -8 <= a <= -1 wird zu ADDQ optimiert. 

SUB wird zu SUBA bzw. SUBI konvertiert. 

SUBA #a,An mit 1 <= a <= 8 wird zu SUBQ optimiert. 

SUBA #a,An mit -8 <= a <= -1 wird zu ADDQ optimiert. 

SUBÄ.L #a,An mit -32768 <= a <= 32767 wird zu »SUBA.W #a,An« opti¬ 
miert. 

SUBI #a,<ea> mit 1 <= a <= 8 wird zu SUBQ optimiert. 

SUBI #a,<ea> mit -8 <= a <= -1 wird zu ADDQ optimiert. 

TRAPHS, THS und TRAPLO, TLO sind Synonyme von TRAPCC, TCC und 
TRAPCS, TCS. 
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3.10 Fehlermeldungen 

Der Assembler bietet ausführliche und präzise Fehlermeldungen, die die Fehlerkorrektur 
erleichtern und in vier verschiedene Kategorien eingeteilt werden können: 

1. Fehler kleiner 100 sind fatale Fehler, die gleich beim Assemblerstart auftauchen. 

2. Fehler von 100 bis 399 sind normale Fehler beim Assemblieren von Quelltextzei- 
len. 

3. »Fehler< von 400 bis 499 sind Warnings, die nur auf außergewöhnliche Zustände 
hinweisen und keine echten Fehler sind. Der Quelltext wird höchstwahrscheinlich 
korrekt übersetzt, aber Sie sollten solche Zeilen kontrollieren, um sicherzustellen, 
daß alles nach Wunsch lief. Ein Beispiel ist die Meldung ides Assemblers, daß 
er eine Prozessorinstruktion auf eine gerade Adresse legt. Ein Label der vorigen 
Zeile könnte dann ungerade sein und eine Adreß-Exception des Prozessors beim 
Ansprung dieses Labels auslösen. 

4. Fehler größer als 900 sind fatale Fehler, die erst während des Assemblerlaufes 
auftreten und die Fortsetzung der Assemblierung unmöglich machen. Ein ( Beipiel 
ist eine interne Division durch Null. 

Einige Fehler fordern Sie auf,, den Fehler beim Hersteller von OMA zu melden. In 
dem Fall sollten Sie dies unverzüglich tun, da diese Fehler beim normalen Ablauf des 
Assemblers nicht Vorkommen sollten und evtl, einen Programmfehler in OM A anzeigen. 

Die Fehlermeldungen selber werden hier nicht aufgeführt. Zum einen sind sie präzise 
genug, um sofort verstanden zu werden, zum anderen wäre es, enorm viel Platz- und 
Zeitverschwendung, sämtliche über 300 Fehler und Warnings mit den Umständen auf¬ 
zuführen, unter denen sie entstehen. 

Falls Sie den Assembler in Batch-Dateien, verwenden wollen, sollten Sie folgendes be¬ 
achten: 

• Tritt ein fataler Fehler auf, wird als Fehlercode die Nummer des Fehlers, zurück¬ 
gegeben (im Bereich 21-99 bzw. 900-999). 

• Tritt sonst mindestens ein einfacher Fehler im Bereich 100-399 auf, wird als Feh¬ 
lercode 10 zurückgegeben. 

• Tritt sonst mindestens ein Warning auf (Bereich 400-499), wird als Fehlercode 5 
zurückgegeben. 

• Sonst wird als Fehlercode 0 zurückgegeben, d.h., es gab weder Fehler noch War¬ 
nings. 
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3.11 Verkürzte Adressierung 

In vielen Programmen werden häufig Variablen angesprochen, die zu einer Bss-Sektion 
gehören. Dies führt z.B. zu folgendem Code: 

CODE 

move d0,wertl ; kein PC-relativ, da Zieladressierung 

move wert2,d0 ; kein PC-relativ, da andere Sektion 

BSS 

wertl ds 1 
sert2 ds 2 

Jeder MOVE-Befehl braucht hier drei Worte. Nun kann die Codegröße und die 
Ausführungszeit gesenkt werden, wenn es möglich ist, die Adressierung von »Absolut 
Langein »Adreßregister indirekt mit Offset« zu wandeln. Dann bräuchte jeder MOVE- 
Befehl nur noch zwei Worte und wäre auf einer MC68000 vier Taktzyklen schneller. Eine 
Mö gli chkeit besteht in der Benutzung des Basereg-Modus (siehe BASERE)G-Direktive), 
aber dies löst nicht das folgende Problem bei Programmen, die in mehrere Module zer¬ 
legt sind: 

File a.asm: 

CODE 

XREF wert,text 
move d0,wert 
lea text,a0 
rts 
END 

File b.asm: 

BSS 

XDEF wert 
basis 

ds .1 1 

wert 

ds.l 1 
END 

File c.asm: 

CODE 

XDEF text 

text ds.b 'Beispiel’ 

END 
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a.asm kann nicht wissen, daß »werte als extern geltendes Symbol verkürzt adressiert 
werden könnte. Nun dürfen aber auch nicht einfach alle externen Werte verkürzt adres¬ 
siert werden, da sonst auf »texte falsch zugegriffen würde. Es gibt leider keine andere 
Lösung als die folgende: 


File a.asm 



CODE 

XREF 

basis,wert,text 


lea 

basis+32768,a5 

initialisiere den Basiszeiger (wie BASEREG) 

Die Initialisierung MUß erfolgen!. 

move 

d0,wert(a5) 

Verkürzung muß (leider) extra angegeben werden, 
es entsteht eine 16-Bit-Referenz 

lea 

rts 

END 

text,a0 

funktioniert fehlerlos 


File b.asm muß zusätzlich »basise exportieren: 

BSS 

XDEF basis,wert 
basis 

ds.l 1 
wert 

ds.l 1 
END 

File c.asm: 

CODE 

XDEF text 

text ds.b 'Beispiel* 

END 

Nun tritt aber noch ein Problem auf: Normale Linker spielen beim Linken der zu¬ 
gehörigen Objektfiles a.obj, b.obj und c.obj nicht mit, da eine 16-Bit-Referenz mit einem 
Symbol gelöst werden soll, das nicht zur gleichen Sektion gehört. Dies führt zu einer 
Fehlermeldung. 

Aber: Mit der SHORT-Option des im Assemblerpaket enthaltenen Linkers DLirik wer¬ 
den die Objektfiles korrekt gelinkt, falls der resultierende 16-Bit-Wert nicht außerhalb 
seines Bereiches gerät und das Symbol zu einer Bss-Sektion gehört. Die Referenz in 
diesem Beispiel ergibt wert-32768 = 4-32768 = -32764 für den Offset, also lautet der 
Befehl im fertigen Programm 

MOVE DO,-32764(A5) 
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Der Linker sorgt automatisch für den zu berücksichtigenden Offset von -32768. 

Der Short-Modus funktioniert auch, wenn mehrere Objektfiles Teile ein und derselben 
Bss-Sektion enthalten, solange die Basisadresse in dem Objektfile definiert wird, das als 
erstes von diesen Objektfiles in der Aufrufzeile steht. Für das folgende Beispiel lautet 
der Linkeraufruf DLink a.obj b.obj c.obj to prg SHORT. File a.asm: 


CODE 

XREF 

basis »wert1,wert2 


lea 

basis+32768,a5 

Initialisierung des Basiszeigers 

move 

d0,wertl(a5) 

wird zu MOVE D0,-32764(A5) 

move 

rts 

END 

d0,wert2(a5) 

wird zu MOVE DO,-32760(A5) 

File b.asm 

: 


BSS 

XDEF 

basis,wert1 



basis 

ds.l 1 
wertl 


ds.l 1 
END 

File c.asm: 

BSS 

XDEF wert2 
wert2 

ds.l 1 
END 

Zur einfachen Behandlung dieser Adressierung sollte für den Basiszeiger eine Zuweisung 
der Form 

BP EQUR A5 ; oder anderer Name 

getroffen werden, damit Befehle z.B. als »MOVE DO,wertl(BP)< geschrieben werden 
können. Dadurch können Verwechselungen mit anderen Adreßregistern vermieden wer¬ 
den. Um das Beschreiben des Basisregisters zu kontrollieren, kann der Basereg-Modus 
eingeschaltet werden, denn dann wird ein Warning gemeldet, wenn das Basisregister 
das Ziel eines Prozessorbefehls ist! 

Hier möchte ich auch auf das entsprechende Kapitel im Linker-Handbuch verweisen. 
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3.12 Das Listingfile 

Das Listingfile des Assemblers enthält vielfältige Information über den Assemblerlauf 
und kann mit vielen Optionen beeinflußt werden. Hier sei auf die Listing-Direktiven 
des Kapitels 3.6 verwiesen. Das Listingfile erzeugen Sie mit der >-l<- oder >-c 1«- 
Startoption, siehe Kapitel 3.2. Zum besseren Verständnis sollten Sie mit dem Listihgfile 
experimentieren, während Sie dieses Kapitel lesen. 

Der Assembler erzeugt im Listing in regelmäßigen Abständen einen Seitenvors f chub, 
der in der ersten Zeile den String der TTL-Direktive und die Seitennummer und in der 
dritten Zeile die Felderaufteilung (auch für die Cross-Referenz und die Symboltabelle) 
enthält. Dieser Seitenyorschub ist vorerst eingeschaltet und kann durch die >-c p«- 
Option und die Direktiven NOPAGE, PAGE und TTL beeinflußt werden. 

Falls Fehler oder Warnings auftraten, erzeugt der Assembler noch eine Fehlerliste, in der 
diese nach der Reihenfolge des Auftretens enthalten sind. Die Fehlerliste wird mit einem 
Seitenvorschub vom Listing abgegrenzt, falls der Seitenvorschub nicht abgeschaltet ist. 

Nach dem Listing wird eine Cross-Referenz oder eine Symboltabelle erzeugt, sofern 
Sie die >-c x<- bzw. >-c t<-Startoption benutzt haben. Wird beides gleichzeitig ver¬ 
langt, erscheint nur die Cross-Referenz, da sie wie eine Symboltabelle ist, aber Verweise 
enthält, wo jedes einzelne Symbol benutzt wurde. Cross-Referenz und Symboltabelle 
werden immer vom Listing bzw. der Fehlerliste durch einen Seitenvorschub äbgegrenzt. 
Ist der Seitenvorschub eingeschaltet, wird er regelmäßig auch in die Cross-Referenz bzw. 
Symboltabelle eingeschoben. 

3.12.1 Das Listing 

Das generelle Format einer Listingzeile lautet: 

ZEILE PC CODE ZEILE QUELLZEILE 

AAAAAA $xxxxxxxx: xxxxXXXXxxxxXXXX Ezzzzzz+ qqq... 

ZEILE ist die gesamte Nummer der Zeile im Assemblerlauf. Der Assembler numeriert 
alle assemblierten Zeilen, also auch solche, die z.B. durch eine Makroexpansion erzeugt 
wurden. 

PC enthält den aktuellen Programmzähler als Hexadezimalzahl und endet mit einem 
Doppelpunkt. Dieses Feld kann leer sein (s.u.). 

Das CODE- Feld enthält in der Regel die durch Prozessorinstruktionen oder Direktiven 
erzeugten Bytes. Falls nötig, werden für eine Quellzeile noch mehrere Zeilen zusätz¬ 
lich erzeugt, die ausschließlich das CODE- Feld enthalten, damit alle erzeugten Bytes 
dokumentiert werden. 

Dan rechte ZEILE- Feld enthält die Nummer der Zeile innerhalb des Quellfiles und 
wird durch ein »E< eingeleitet, wenn die Zeile einen Fehler enthält. Das >-(-< er¬ 
scheint, wenn die Zeile durch eine Makroexpansion entstanden ist, also aus einem Makro 
stammt. 
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Schließlich wird die Quellzeile im QUELLZEILE -Feld untergebracht. 

Für spezielle Direktiven enthält das CODE -Feld andere Information als die erzeugten 
Bytes. Im folgenden sind die einzelnen Ausgaben für diese Direktiven beschrieben: 

OFFSET: Der Anfangswert des Offsetzählers wird mit einem Gleichheitszeichen aus¬ 
gegeben. 

EQU: Es erscheint ein Gleichheitszeichen. Wenn der Wert absolut oder relativ ist, 
folgt er als Hexadezimalzahl. Ist er relativ, folgt noch ein einfaches Hochkomma. 
Ist der Wert importiert, wird dies als Text kenntlich gemacht. 

SET: Die Ausgabe ist die gleiche wie bei EQU mit dem Unterschied, daß statt des 
Gleichheitszeichens die Kombination -> erscheint. 

EQUR: Es erscheint der Text >= Register Xn<, wobei »Xn< durch das entspre¬ 
chende Daten- oder Adreßregister ersetzt wird. 

SETR: Es besteht der gleiche Unterschied wie zwischen EQU und SET. 

REG: Der Assembler erzeugt »= Maske xxxx«, wobei »xxxx« durch die Maske als 
16-Bit-Hexadezimalzahl ersetzt wird. 

SETREG: Es besteht der gleiche Unterschied wie zwischen EQU und SET. 

DCB: Der Assembler erzeugt >= xxxxxxxx Bytes«, wobei »xxxxxxxx« durch die 
Anzahl der erzeugten Bytes als Hexadezimalzahl ersetzt wird. 

DS: Normalerweise ist die Ausgabe dieselbe wie bei der DCB-Direktive. Im Offset¬ 
abschnitt wird der Offsetzähler mit einem Gleichheitszeichen ausgegeben. 

RS: Der RS-Zähler wird mit einem Gleichheitszeichen ausgegeben. 

INCBIN: Hier fehlt das Dokumentieren der eingelesenen Bytes. Dies ist sinnvoll, da 
ein INCBIN-File beliebig groß sein darf. Entsprechend viele Zeilen würden im 
Listing benötigt, um alle Bytes auszugeben, so daß das Listingfile größer als der 
ursprüngliche Quelltext würde. 

IF: Bei den IF-Direktiven erscheint »Wahr«, wenn die Bedingung wahr ist. Sonst 
erscheint »Falsch«. 

ELSE: Die Ausgabe ist dieselbe wie bei den IF-Direktiven, bezieht sich aber auf den 
umgekehrten Wahrheitsgehalt. 

3.12.2 Cross-Referenz und Symboltabelle 

Wie oben schon erwähnt, ist die Cross-Referenz im Prinzip eine Liste mit allen im As¬ 
semblerlauf vorgekommenen Symbolen, die für jedes Symbol neben der Zeilennummer 
der Definitionszeile auch alle Zeilennummern der Zeilen enthält, in denen das jeweilige 
Symbol auftaucht. Die Cross-Referenz muß mit der »-c x«-Startoption explizit von 
Ihnen angefordert werden. Das generelle Format einer Cross-Referenz-Zeile lautet: 

SYMBOL ZEILE WERT REFERENZEN 

12345678901234567890123456789012 zzzzzz xxxxxxxx’ zzzzzz 
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Das SYMBOL- Feld enthält den Namen des Symbols. Falls dieser länger als 32 Zeichen 
ist, wird er komplett ausgegeben, und die übrigen Felder bekommen eine eigene Zeile. 

Das ZEILE- Feld enthält die Gesamt-Zeilennummer der Zeile, in der das Symbol defi¬ 
niert wurde (nicht die Nummer innerhalb des Quellfiles!). 

Das WERT-Feld enthält den Wert bzw. die Art des Svmboles. Ist es ein relativer Wert., 
wird noch ein einfaches Hochkomma angehängt. Das Symbol kann von den folgenden 
Symboltypen sein: 

• Absolut 

• Relativ 

• Importiert 

• Fließkommasymbol 

• Registersymbol 

• Registermaske 

• Makro 

• Undefiniertes Symbol (z.B. in ausgeschlossenem IF-Abschnitt) 

• Mehrfach definiertes Symbol (d.h., es gab Fehler beim Assemblieren) 

REFERENZEN enthält dann die Gesamt-Zeilennummern (nicht die Nummer inner¬ 
halb des Quellfiles!), in denen das Symbol benutzt wurde. Es werden so viele Nummern 
ausgegeben wie nötig sind, um die mit LLEN eingestellte maximale Zeilenlänge zu er¬ 
reichen. Wenn nötig, werden weitere Zeilen erzeugt, die die Zeilennummern enthalten. 

Falls Ihnen die Cross-Referenz zu groß ist, Sie aber dennoch einige Symbolwerte wissen 
möchten, dann verlangen Sie per >-c t<-Start,option die Symboltabelle. Bis auf das 
Fehlen des REFERENZEN- Feldes (das evtl, sehr viel Platz beanspruchen kann), ist die 
Symboltabelle mit der Cross-Referenz identisch. 


3.13 Vorassemblierte Includefiles 

OMA bietet die Möglichkeit, Includefiles vorzuassemblieren und Zeit beim späteren 
Assemblerlauf zu sparen. Ein File namens prog.asm enthalte beispielsweise die folgende 
Sequenz: 

include "exec/types.i" 
include "intuition/intuition.i" 

Es werden sehr viele Konstanten und Makros durch die Includefiles gelesen, da intuition .i 
noch selber etliche Includefiles holt. Für jeden Assemblerlauf heißt dies, daß jedesmal 
dieselben Werte definiert werden und dieselben Zeilen zu lesen und zu zerlegen sind. 
Diese Arbeit läßt sich abkürzen. 

Assemblieren Sie die obige Sequenz z.B. als File file.asm durch 
OHA file.asm -c n -t Vorassembliert 

Sie erhalten dann ein vorassembliertes File namens Vorassembliert, das alle mit EQU, 
SET, FEQU, FSET, REG, SETREG, EQUR, SETR und MACRO definierten Konstan¬ 
ten und Makros aus den Includefiles enthält (da END fehlt, werden Sie ein Warning 
bekommen; >-c n« wird benutzt, damit kein Objektfile erzeugt wird). Entfernen Sie 
die obige Include-Sequenz aus dem ursprünglichen Quelltext prog.asm, damit die Inclu¬ 
defiles nicht mehr gelesen werden, und assemblieren Sie per 

OMA prog.asm -o prog -p Vorassembliert 

Der Assembler liest die Konstanten und Makros aus Vorassembliert sehr schnell ein und 
assembliert, den übrigen Quelltext prog.asm. Die zum Assemblieren benötigte Zeit ist 
im Vergleich zum Lesen der Includefiles stark gesunken. Da OMA in Bezug auf die 
vorassemblierten Files sehr empfindlich ist, sei die folgende Warnung angeführt: 

ACHTEN SIE DARAUF, DAß DIE VORASSEMBLIERTEN INCLUDE¬ 
FILES VON OMA ERZEUGT UND NICHT IN IRGENDEINER FORM 
VERÄNDERT WURDEN. SONST WIRD DER ASSEMBLER SEHR GIF¬ 
TIG REAGIEREN: MIT EINEM SYSTEMABSTURZ. 

Sofern Sie sichere Datenträger verwenden, kann aber so gut wie nichts passieren. Selbst 
wenn Sie echte Includefiles als vorassemblierte benutzen wollten, würde OMA dies recht¬ 
zeitig bemerken und melden. Vorassemblierte Includefiles können auch mittels der Di¬ 
rektive INCPRE gelesen werden. 
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3.14 Source-Level-Debugging 

Source-Level-Debugging bedeutet, daß der Quelltext eines Programmes genau so im 
Debugger verfügbar ist, wie er in der Quelldatei steht. OMA unterstützt eine solch 
hochbequeme Form des Debuggens. Dabei kann ausgewählt werden, welche Teile als 
Source-Level-Information vorliegen sollen und welche nicht. 

Wenn die Startoption >-c q« angegeben ist, wird der Assembler Quelltextzeilen in 
einem speziellen Format in einen Debughunk abspeichern. Normalerweise gelangen 
alle Zeilen außer Leerzeilen in diesen Hunk, die auch in das Listingfile gelangen 
würden. Wenn gleichzeitig ein Listingfile erzeugt wird, gelangen auch die Leerzeilen 
in den Debughunk. Dabei ist es dann möglich, die Steuerung über die Listingdirekti- 
ven LIST, NOLIST, CLIST usw. auszunutzen, um selektiv Quelltextteile zum Source- 
Level-Debugging in den Debughunk zu schreiben. Per Makros expandierte Quellzeilen 
können auch vollständig geschrieben werden. Damit stehen dem Debugger DBug für 
echtes Source-Level-Debugging alle notwendigen Informationen zur Verfügung! 

Module, die ohne Source-Level-Information erzeugt werden, haben im Debugger einfach 
keine Darstellung in der Source-Level-Ebene. 

Leider ist der Debughunk durch Commodore nur schwach genormt, daher können an¬ 
dere Debugger bzw. Linker als DBug bzw. DLink nichts mit den Daten anfangen. Daher 
sollten Sie unbedingt mit DLink linken. Zudem kann im Extremfall (wenn auch die In- 
cludefiles u.ä. in den Debughunk gelangen) der Dateiumfang eines Objektfiles um mehr 
als das zehnfache zunehmen. Daher sollten nur wenige Programmteile auf voller Source- 
Level-Ebene betrieben werden bzw. es sollte genug Speicher zur Verfügung stehen. 


3.15. 32-BIT-PROZESSOREN UND 32-BIT-PROBLEME 
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3.15 32-Bit-Prozessoren und 32-Bit-Probleme 

Da OMA die 32-Bit-Prozessoren unterstützt, ergeben sich kleinere Probleme gegenüber 
den 16-Bit-Prozessoren. Sie sollten immer die Form »bra.w« statt »bra.l< verwenden, 
da der lange Branch im 32-Bit-Modus als 32-Bit-Befehl assembliert wird. Die 16-Bit- 
Prozessoren interpretieren diesen Befehl falsch und geraten auf eine ungerade Befehls¬ 
adresse. Daher erhalten Sie im 16-Bit-Modus bei »bra.l« ein entsprechendes Warning. 
Beachten Sie ferner, daß jetzt mehr Symbolnamen reserviert sind, um die zusätzlichen 
Prozessorregister zu unterstützen. 

Ferner ist es ein Problem, daß externe, relative 32-Bit-Referenzen durch Amiga-DOS 
nicht aufgelöst werden können, da entsprechende Hunktypen nicht definiert wurden. 
Wenn z.B. »that« importiert ist, sind folgende Befehle bzw. Adressierungsarten nicht 
möglich (dies betrifft nur die 32-Bit-Prozessoren), und OMA meldet einen Fehler: 

bra.l that 
fbeq.l that 
move (that,pc),dO 
move (that,pc,dl),d0 
move ([that,pc],dl),d0 
move ([that,pc,dl]),d0 

Sofern Sie Programme für den MC68040-Prozessor schreiben wollen, sollten Sie be¬ 
achten, daß bei diesem der Cache ganz anders als bei den anderen 32-Bit-Prozessoren 
angesteuert wird und die PMMU-Befehle eine völlig unterschiedliche Kodierung ha¬ 
ben. PMMU-Befehle der MC68030 erzeugen auf dem MC68040 eine Illegal-Opcode- 
Exception und umgekehrt. Achten Sie also darauf, welchen Prozessor Sie für die As¬ 
semblierung bei PMMU-Befehlen ausgewählt haben, und daß Sie ab System 2.0 für 
Cache-Behandlung die entsprechenden Exec-Routinen benutzen. 



Kapitel 4 


Symbolischer Debugger 
DBug VI.1 

4.1 Einführung 

DBug ist ein Source-Level-Multiwindow-Debugger für die Commodore-Amiga-Familie. 
Sein Konzept, umfaßt eine durchgängige Bedienung des Programmes durch Maus und 
Tastatur nebst vollständig symbolischem Debuggen von beliebigen Tasks, die vom CLI 
oder der Workbench gestartet werden oder auch schon länger im System laufen. DBug 
läuft auf allen Amiga-Modellen und in Verbindung mit allen Prozessoren der Motorola- 
68000-Familie sowie der Fließkomma-Coprozessoren. Befehle und Eigenschaften für die 
höheren Prozessoren werden ebenso automatisch erkannt, verarbeitet und unterstützt 
wie die neuen Betriebssysteme ab 2.0. In diesem Handbuch sollen Kickstart 1.3 und 
Kickstart 1.2 gleichbedeutend sein. 

Da. DBug ausgiebig die Intuition-Fenstertechnik gebraucht, können Sie mit ihm keine 
Programme debuggen, die das System ausschalten oder andere unsaubere »Tricks« 
anwenden. Die Anzahl möglicher Fenster selbst gleichen Typs ist. nur durch den Speicher 
begrenzt.. Es ist also kein Problem, z.B. 20 Speicherfenster gleichzeitig offen zu haben. 
Jedes Fenster besitzt aber seine individuelle Einstellung; z.B. beeinflußt eine Änderung 
der Sortierung des einen Symbolfensters nicht die Sortierung eines anderen. 

Hier noch eine kleine Zusammenfassung der Leistungsmerkmale: 

• symbolischer Multiwindow-Debugger mit. Unterstützung aller Prozessoren 

• Source-Level-Unterstützung bietet Abarbeitung direkt, im Quelltext 

• für alle Amiga,-Modelle und alle Betriebssysteme ab Kickstart 1.2 

• Debuggen beliebiger Tasks oder Programme 

• Einzelschritt,modus, schnelles Ausführen von Unterprogrammen 
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• Breakpoints, Speicher-Breakpoints, zeitweilig ausschaltbar 

• Anzeige beliebiger Speicherbereiche in verschiedenen Formaten, integrierter As¬ 
sembler und Disassembler für alle Prozessoren 

• History-Funktion mit beliebiger Tiefe 

• Logfile zum Protokollieren 

• fontsensitiv: verwendet den eingestellten System-Defaultfont, 

Starten des Debuggers 

Sie starten den Debugger vom CLI, einer Shell oder der Workbench. Für den 
Workbench-Start klicken Sie einfach sein Icon doppelt an. Vom CLI aus geben Sie 
den Namen DBug als Befehl ein und drücken Return, DBug startet sich dann intern 
als selbständige Task und läßt das CLI unabhängig weiterlaufen. Sie können beim CLI- 
Start gleich ein Programm zum Debuggen anwählen, indem Sie seine CLI-Start,zeile an 
den Debuggernamen anhängen. Dieses Programm wird dann sofort eingeladen und zum 
Debuggen vorbereitet. Dazu sollten Sie den Programmnamen allerdings so weit ange¬ 
ben, daß der Debugger das Programmfile finden und die Symbole laden kann. Sofern 
Sie z.B. nicht im C:-Directory sind, reicht der Name filenote nicht aus, Sie müssen dann 
C:filenote angeben. 

Zum Start von der Workbench klicken Sie das Icon des Debuggers wie gewohnt dop¬ 
pelt an. Wollen Sie gleichzeitig schon ein Programm zum Debuggen auswählen, dann 
verwenden Sie die erweiterte Auswahl wie üblich. 

Vor Öffnen des Standardfensters versucht der Debugger, aus dem aktuellen Directory 
ein File namens DBug.prefs zu lesen. Vom Debugger erzeugt, kann dieses die Fenster¬ 
einstellung der letzten Debug-Sitzung enthalten, und DBug öffnet, die Fenster exakt so, 
wie Sie sie abgespeichert haben (siehe auch Window-Menü). Da Amiga-DOS relokatible 
Programme verwendet, bleibt Ihnen allerdings nicht erspart, z.B. Speicherfenster auf 
die richtige Startadresse zu setzen. Gibt es kein File namens DBug.prefs oder stimmt 
dessen Prüfsumme nicht, dann öffnet sich einfach ein normales Statusfenster in der 
linken oberen Ecke. 

DBug kann zwar resident gehalten werden, und Sie können DBug mehrfach nebenein¬ 
ander starten und laufenlassen, er ist aber nicht so weit residentfähig, daß sein Code 
von mehreren Prozessen gleichzeitig ausgeführt werden darf. 
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4.2 Eingabe-Elemente 

Die Maus ist das wichtigste Mittel zur Bedienung von DBug. Mit ihr können neue 
Fenster geöffnet oder Fensterdaten durch Anklicken manipuliert werden, wobei der 
Doppelklick eine besondere Rolle spielt. Die Tastatur ist nur für ergänzende Eingaben 
und Menü-Abkürzungen vorgesehen. Der Debugger verwendet ausgiebig Fenster zur In¬ 
formationsausgabe. Zur Abfrage von Werten gibt es noch spezielle Fenster, sogenannte 
Requester. 

4.2.1 Anklicken von Daten 

Alle DBug-Fenster enthalten Texte mit Daten. Einige Textbereiche sind anklickbar 
und werden grafisch hervorgehoben, wenn Sie auf diese bei gedrückter, linker Maustaste 
zeigen. Angeklickte Werte dürfen Sie für weitere Operationen verwenden, indem Sie z.B. 
das Übernahine-Gadget eines anderen Fensters anklicken und damit dieses Fenster auf 
den angeklickten Wert einstellen (die Reaktion des Fensters hängt von seinem Typ ab). 
Drücken Sie während des Anklickens eine Alt-Taste, so multipliziert der Debugger den 
angeklickten Wert vor Gebrauch mit vier. Dabei wird der Wert aber nicht im Fenster 
oder Speicher geändert, sondern nur intern vor Benutzung mit vier multipliziert. 

Sie können einen Wert nur so lange verwenden, wie er angeklickt ist. Anklicken einer 
anderen Stelle hebt die letzte Hervorhebung auf und den neu angeklickten Wert hervor. 
Sollte die neue Stelle nicht anklickbar sein, dann gibt es keinen angeklickten Wert. 

Einige Funktionen des Debuggers verwenden einen angeklickten Wert, sofern ein solcher 
existiert, und bringen sonst einen Frage-Requester hervor, mit dein Sie zur Eingabe 
notwendiger Daten aufgefordert werden. Siehe auch unten folgenden Paragraphen 4.2.3. 

Ein Doppelklick auf ein Datum bewirkt in der Regel bei allen Fenstern, daß ein Spei¬ 
cherfenster mit dem Datum als Startadresse geöffnet wird. Doppelklicken Sie also in 
einem Speicherfenster auf ein Langwort, das einen Zeiger enthält, so öffnet sich ein Fen¬ 
ster mit dessen Inhalt. Sollte es sich um einen BCPL-Zeiger handeln, müssen Sie nach 
dem oben Gesagten nur zusätzlich eine Alt-Taste drücken, um die korrekte Adresse 
zu erhalten. Soll das Fenster gleich mit dem Disassembler arbeiten, dann drücken Sie 
gleichzeitig die Control-Taste. 

Merkregel: Einfacher Doppelklick öffnet Speicherfenster, mit gedrückter Shift-Taste 
können Sie editieren (siehe Status- und Speicherfenster), mit Alt-Taste wird ein 
BCPL-Zeiger referenziert und mit Control-Taste gleich der Disassembler einge¬ 
schaltet. Beachten Sie, daß <Alt> und <Control> auch beide gleichzeitig benutzt 
werden können und daß es von dieser Regel auch Ausnahmen gibt, z.B. das FPU- 
Statusfenster, bei dem ein Doppelklick auf das FPSR sofortiges Editieren erlaubt. 


4.2.2 Fenster-Eigenschaften 

Alle Fenster sind verschiebbar und lassen sich in den Vorder- bzw. Hintergrund legen. 
Die meisten Fenster lassen sich in ihrer Größe verändern und besitzen einen Satz von 
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Gadgets an der rechten Fensterumrandung. Zu diesen Gadgets gehört eine Kombina¬ 
tion von einem Scrollbar mit Pfeil-Gadgets, mit der Sie Ausschnitte aus der Darstel¬ 
lung des jeweiligen Fensters anwählen. Die Art des Ausschnitts hängt vom Fenstertyp 
ab. Der Scrollbar zeigt durch seine Höhe immer die Ausschnittgröße bezogen auf die 
Gesamtgröße an Fensterdaten an, und seine Position indiziert die Ausschnittposition 
innerhalb der Datenmenge. Die Pfeil-Gadgets wählen die vorige bzw. nächste Darstel¬ 
lungszeile. 

Wenn nicht editiert wird, dann simulieren bei den meisten Fenstern <Cursor-hoch> 
und <Cursor-runter> den Klick auf das entsprechende Pfeil-Gadget, d.h. zeilenweises 
Scrollen. Bei gleichzeitigem Drücken von <Shift> wird jeweils das Klicken über bzw. 
unter den Knopf des Scrollbars simuliert, d.h. seitenweises Blättern. 

Das Übernahine-Gadget befindet sich zwischen Size-Gadget und dem Pfeil-Runter- 
Gadget. Wenn Sie es anklicken, wird entweder der gerade angeklickte Wert als 
Darstellungs-Startwert für das Fenster übernommen, oder (falls ein solcher nicht exi¬ 
stiert) der Debugger fragt Sie über einen Requester nach dem Startwert. 

Das Rückwärts-Gadget gibt es nur bei Speicherfenstern. Es stellt die Adresse ein Wort 
bzw. Byte rückwärts. Siehe Speicherfenster. 

4.2.3 Requester 

Requester sind spezielle Debugger-lenster, die das Fortsetzen einer Operation erst nach 
Eingabe von Daten erlauben. Im Gegensatz zu Intuitions Requestern können Sie an¬ 
dere Teile des Debuggers bedienen, ohne einen Requester beantwortet zu haben, so 
können Sie z.B. ein Symbolfenster öffnen und einen Symbolwert nachgucken, um die 
neue Startadresse eines Speicherfensters anzugeben. Dabei ist es aber nicht möglich, 
weitere Requester aufzurufen. Es kann gleichzeitig nur ein einziger Requester geöffnet 
sein. 

Sobald ein Requester erscheint, ist eines seiner Eingabefelder (dies sind Intuition-String- 
Gadgets) aktiviert und wartet auf Ihre Eingabe über die Tastatur, die übrigen sind leer 
oder aber bereits mit von Ihnen änderbaren Standardwerten initialisiert. Falls ein ange¬ 
klickter Wert existiert, übernehmen einige Requester diesen in eines der Eingabefelder. 

Sie können einen Requester ohne Eingabe beenden, indem Sie entweder sein Close- 
Gadget anklicken oder das Cancel-Gadget bedienen. Die Eingabe bestätigen Sie durch 
Drücken der Return-Taste oder durch Anklicken des Ok-Gadgets. Die gewählte Funk¬ 
tion wird erst ausgeführt, wenn alle Eingabewerte besetzt und auf Korrektheit überprüft 
sind. 

Bei Falsch-Eingaben druckt der Debugger entsprechende Fehlermeldungen in die ober¬ 
ste Textzeile eines Requesters und beendet den Requester nicht, sondern verlangt eine 
Neueingabe. Dabei ist immer der Requester-Wert aktiviert, in dem der Fehler lokali¬ 
siert wurde. Dadurch können Sie einfach durch Drücken der Return-Taste vom letzten 
Eingabefeld zum nächsten leeren Eingabefeld springen, ohne die Maus zu benutzen. 
Wollen Sie allerdings einen vom Debugger vorgegebenen Wert ändern, müssen Sie mit 
der Maus arbeiten. In den Eingabefeldern gibt es die folgenden Editiermöglichkeiten: 
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<Cursor-links> bewegt den Cursor nach links. 

<Cursor-recht,s> bewegt den Cursor nach rechts. 

<Shift> + <Cursor-links> setzt den Cursor auf den Stringanfang. 

<Shift> + <Cursor-rechts> setzt den Cursor auf das Stringende. 

<Amiga>-f<X> löscht den String. 

<Amiga> + <Q> restauriert den String so, wie er beim Editierbeginn war. 
<Delete> löscht das Zeichen unter dem Cursor. 

<Backspace> löscht das Zeichen links vom Cursor. 

4.2.4 Integer-Ausdrücke 

Sie dürfen bei Eingabe von Werten beliebige Ausdrücke angeben. Die Ausdruckaus¬ 
wertung ist weitgehend mit der des Optimierenden-Makro-Assemblers identisch (siehe 
auch OMA-Handbuch), es gelten aber alle Werte als absolute Integer, relative gibt es 
bei DBug nicht. 

Ausdrücke werden hierarchisch ausgewertet, z.B. geht Punkt- vor Strichrechnung. Die 
Operanden können ein Symbolname sein (dieser wird automatisch durch seinen Wert 
ersetzt), der Name eines Daten- oder Adreßregisters (dieser wird durch den aktuellen 
Wert des Registers ersetzt) oder eine Zahl. Die Zahl kann in folgenden Zahlensystemen 
angegeben werden: 

• dezimal ohne spezielle Angabe, z.B. »45<. 

• hexadezimal mit einleitendem Dollarzeichen »$«, z.B. »$4e75<. 

• oktal mit einleitendem At-Zeichen >'&<, z.B. »@17«. 

• binär mit einleitendem Prozentzeichen »%<, z.B. »%1001001011«. 

• Stringkonstante in ASCII-Format. Diese beginnt mit einfachem oder doppeltem 
Hochkomma und muß auch mit diesem wieder enden, darf maximal vier Zeichen 
lang sein, wird rechtsseitig aufgefüllt und ermöglicht es, das einfassende Hoch- 
kornma in sich Vorkommen zu lassen, wenn es doppelt angegeben wird. Z.B.: "th" 
'lang’ ’it’V 

• beim Assemblierer! der aktuelle Programmzähler »*«. 

Symbolnamen beginnen mit einem Buchstaben, Punkt oder einem Unterstrich. Nach 
dem ersten Zeichen sind außerdem noch Ziffern zugelassen. Lokale Label (siehe OMA- 
Handbuch) sind ebenfalls möglich, hinter dem Dollarzeichen >$< muß bei ihnen aber 
ihre einmalige Kennung angegeben werden (siehe solche Namen im Symbolfenster). Als 
Buchstaben sind auch die internationalen Zeichen des Amiga erlaubt, z.B. ist der Name 
>Zähler< korrekt. 

Bitte beachten Sie, daß lokale Label in zu debuggenden Programmen nicht eindeutig 
sind, wenn diese aus mehreren Modulen bestehen. Dies kann speziell beim Assemblieren 
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in Speicher fenstern zu Meldungen wie »Out of ränge« o.ä. führen, da ein falsches, 
gleichnamiges Symbol herausgesucht wird. 

Es wird immer mit ganzzahligen, vorzeichenbehafteten Werten von 32 Bit Länge ge¬ 
rechnet. Folgende Operatoren sind gültig: 


Priorität 

Operator 

Bedeutung 

5 

+ 

Monadisches Plus 

5 

- 

Monadisches Minus 

5 

~ 

Logisches Negat. (Tildezeichen) 

4 

>> 

Rechtsverschieben (zweimal »>«) 

4 

<< 

Linksverschieben (zweimal »<«) 

3 


Logisches Exklusiv-Oder (»Dach«) 

3 

& 

Logisches Und 

3 

| 

Logisches Oder 

3 

t 

Logisches Oder 

2 

% 

Modulo 

2 

/ 

Division 

2 

* 

Multiplikation 

1 

- 

Subtraktion 

1 

+ 

Addition 


Operatoren mit höherer Priorität werden zuerst berechnet. Die Priorität kann durch 
Klammerung durchbrochen werden. Die Klammerverschachtelung reicht zusammen mit 
der Operatorverschachtelung bis zu 32 Ebenen tief. Die Operatoren mit der Priorität 
5 sind monadische Operatoren, haben also nur einen Operanden, der unmittelbar auf 
den Operator folgt. 

Nun noch ein paar Beispielausdrücke: 

3+4*5 ergibt 23 

’2’+start ergibt $34, wenn "start" den Wert 2 hat 
"2'' ergibt einen Fehler, korrekt ist "2" oder ’2’ 

*-start ergibt 4, wenn "start" = 2 und der Programmzähler = 6 ist 
~1 ergibt SFFFFFFFE = -2 

(8>>2) acht, zweimal nach rechts geshiftet (ergibt 2) 

(1<<7) eins, siebenmal nach links geshiftet (ergibt $80) 

(1<<7)!1 ergibt $81 

(80+128)<<16!(32+128)<<4 ergibt $00D00A00 
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zugelassen. Als Operatoren sind dann nur noch die Grundrechenarten »+«, »-«, »*«, 
»/« und der Modulo-Operator »%« mit der gleichen Priorität wie oben angegeben zu¬ 
gelassen. Dabei sind auch Symbolnamen oder Daten- oder Adreßregisternamen erlaubt, 
die in Flicßkornmawerte umgewandelt werden. 

Die Fließkommazahlen werden im üblichen Format spezifiziert, d.h. zuerst ein Vorzei¬ 
chen, dann eine Zahl mit oder ohne Kommastelle (als Punkt anzugeben), dann ein »E« 
oder »e« zur Einleitung des Exponenten und daraufhin der Exponent selber, evtl, eben¬ 
falls mit Vorzeichen. Der Wertebereich geht bei ca. 19 Stellen Genauigkeit von 6*10 4931 
bis 9*10 -4952 . Wie bei Integer-Ausdrücken wird ein Fließkomma-Ausdruck hierarchisch 
berechnet und kann ebenfalls bis zu 32 Ebenen tief verschachtelt werden. 

Beispiele für Fließkommazahlen und -ausdrücke: 

• 3.1415926535*24.3+8 

• -5.61e-25 

• .00004592834 

• +3 

Beachten Sie, daß Sie Fließkomma-Ausdrücke nur verwenden können, wenn Sie einen 
Fließkomma-Coprozessor vom Typ MC68881 oder MC68882 oder eine MC68040-MPU 
in Ihrem Rechner eingebaut haben. 


4.2.5 Fließkomma-Ausdrücke 


Beim Assemblieren von FPU-Befehlen und Eingaben im FPU-Statusfenster können 
auch Fließkomma-Ausdrücke ausgewertet werden, und es sind dann Fließkommazahlen 
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4.3 Fenstertypen 

DBug besitzt mehrere Typen von Fenstern. Es gibt u.a. Speicherfenster und registeran¬ 
zeigende Statusfenster. Im folgenden werden die Eigenheiten der verschiedenen Typen 
beschrieben. 

4.3.1 Das Speicherfenster 

Dieses Fenster ist das wichtigste von allen. Mit ihm haben Sie die Möglichkeit, Daten 
verschieden formatiert im Speicher anzusehen. Eine Zeile beginnt in der Regel mit der 
Speicheradresse, darauf folgt der Datenteil und optional ein Textblock, der die Daten in 
ASCII-Form sichtbar macht. Die Daten werden zehnmal pro Sekunde auf den neuesten 
Stand gebracht. Dadurch können sich ständig ändernde Wert beobachtet werden, oder 
Sie können zugucken, wie Ihr Programm arbeitet. 

Das Adressenformat ist einstellbar (siehe Address-Menii) und hat regulär sechs Stellen 
bei einem MC68000/010-Prozessor und acht Stellen bei den höheren Prozessoren. Falls 
es ein Symbol mit der Speicheradresse gibt, wird eine Symbolzeile mit dessen Namen 
vor der Datenzeile eingeschoben. Sofern ein Symbol mit seiner Adresse zwischen dem 
Beginn eines Datums und seinem Ende liegt, erhält es ebenfalls eine eigene Zeile, ist 
dann aber eingeklammert. 

Der Datenteil enthält die Daten in wählbarem Format (siehe Data-Menü), dabei exi¬ 
stiert auch das Einschalten eines Disassemblers für die Motorola-Prozessoren. Der 
Disassembler unterstützt alle MPUs einschließlich Fließkomma-Coprozessoren. Als 
PMMU-Befehle existieren nur die der MC68030, da das einzige Amiga-Board, das die 
MC68851 PMMU benutzt (die noch viel mehr Befehle und Register als die MC68030 
hat), das Commodore-Board A2620 ist. Falls möglich, werden im Disassembler-Listing 
Adressen durch Symbolnamen ersetzt, so daß der Code wieder leicht lesbar wird. 
Darüberhinaus erscheinen Quell- und Zieladresse als Kommentare hinter den Instruk¬ 
tionen. Die Werte des Disassemblers sind alle anklickbar, doppelklicken Sie z.B. einen 
Variablennamen, dann öffnet sich ein Speicherfenster mit der Adresse der Variablen 
als Startadresse. Beim Disassembler ist die Adresse der nächsten auszuführenden In¬ 
struktion zusätzlich mit einem Stern gekennzeichnet. Handelt es sich sogar um ein 
PC-Disassembler-Fenster, dann folgt dessen Inhalt immer dem aktuellen PC. 

Das Rückwärts-Gadget. über dem Scrollbar bewirkt, daß die Startadresse des Fensters 
um ein Wort zurückgeschaltet wird. Ist der Disassemblermodus abgeschaltet und By¬ 
tegröße eingeschaltet, dann wird ein Byte zurückgegangen. 

Durch Bedienung des Übernahme-Gadgets wird der gerade angeklickte Wert als Start¬ 
adresse übernommen. War nichts angeklickt, geht der Frage-Requester auf. Ist es Hunk- 
Range, dann wird der Bereich sofort auf den Hunk gesetzt, in dem die Adresse liegt. 
Bei Absolute-Range wird gemeckert (wenn Frage-Requester) bzw. gebeept, wenn die 
Adresse nicht im gewählten Bereich ist. 

Ein normaler Doppelklick öffnet ein Speicherfenster mit der angeklickten Adresse als 
Startadresse. Ist es ein Opcode beim Disassembler, so springt ein Cursor in die Zeile, 
und Sie haben die Möglichkeit, Instruktionen zu editieren und zu assemblieren (siehe 
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Editiermöglichkeiten unten). Der Assemblerteil besitzt dieselben Fähigkeiten wie der 
Disassembler und stellt, falls nötig, den Cursor auf die Stelle, an der Sie evtl, einen 
Fehler gemacht haben. Die Fehlermeldung finden Sie dann in dem Fenstertitel. 

Ist es bei ausgeschaltetem Disassembler ein Doppelklick auf ein Datum mit gedrückter 
Shift-Taste, dann geht ein Cursor in die Zeile und erlaubt Editieren der Daten wie 
in einem Intuition-String-Gadget. einschließlich Cursorpositionierung mit der Maus wie 
folgt: 

<Cursor-links> bewegt den Cursor nach links. 

<Cursor-rechts> bewegt den Cursor nach rechts. 

<Shift> + <Cursor-links> setzt den Cursor auf den Stringanfang. 
<Shift>+<Cursor-rechts> setzt den Cursor auf das Stringende. 

<Amiga>-(-<X> löscht den String. 

<Amiga> + <Q> restauriert den String so, wie er beim Editierbeginn war. 
<Delete> löscht das Zeichen unter dem Cursor. 

<Backspace> löscht das Zeichen links vom Cursor. 

Die Daten werden bei Verlassen der Zeile in den Speicher geschrieben. Sie brechen das 
Editieren durch Drücken der Escape-Taste oder Wählen einer anderen Funktion (z.B. 
eines Menüs) ab. Die Return-Taste schreibt die Daten und beendet das Editieren. Mit 
<Cursor-hoch> und <Cursor-runter> wählen Sie zusätzlich die vorige bzw. nächste 
Zeile an, sofern der Bereich nicht überschritten wird. Bevor die Daten geschrieben 
werden, werden sie u.a. auf korrekten Bereich geprüft. Ist etwas falsch, dann wird eine 
Fehlermeldung in den Fenstertitel gedruckt und die Zeile nicht verlassen. 

Es ist noch wichtig zu wissen, daß der durch Speicherfenster und BigStatus-Fenster er¬ 
reichbare Adreßraum eingeschränkt ist. Wenn nämlich ein Zugriff durch den Debugger 
außerhalb des gültigen Adreßraums erfolgt, wird durch dauernde Exception-Auslösung 
z.B. auf einem Amiga 3000 der ganze Rechner extrem stark verlangsamt. Daher wird in¬ 
tern automatisch nur der adressierbare, vorhandene Speicher sowie der Bereich SF80000 
bis SFFFFFF zugelassen. Weitere Bereiche müssen in Textfiles abgelegt werden, die 
DBug.memory heißen und in dem Directory sein dürfen, aus dem der Debugger gestar¬ 
tet wird, sowie in dem DEVS:-Directory. Falls sowohl im aktuellen Directory als auch 
im DEVS:- Directory ein Speicherfile vorhanden ist, werden beide eingelesen und deren 
Bereiche überlagert. Dadurch kann man einmal global einen Speicherbereich anwählbar 
machen (DEVS:) und einmal lokal (aktuelles Directory). Eine Zeile dieser Textfiles hat 
das Format: 

$EOOOOO - $E00FFF ;dies ist ein Kommentar 
(weitere Zeilen) 

Als Trennzeichen sind Leer- oder Tabualtorzeichen zugelassen. Ein Zeilenende wird 
durch Linefeed oder Carriage Return erkannt. Nullbytes werden durch Spaces ersetzt. 
Das File darf maximal 4095 Bytes lang sein. Sollte das File irgendwie falsch sein, beept 
das Display. Die Endadresse gilt als einschließlich. 
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4.3.2 Das Statusfenster 

Das Statusfenster gibt Ihnen den wichtigen Einblick in den Registerzustand des Prozes¬ 
sors. Es stellt alle Daten- und Adreßregister, den Programinzähler PC, die Statusflags 
sowie den als nächstes auszuführenden Befehl disassembliert. dar. Darüberhinaus be¬ 
kommen Sie hier Statusinformation des Debuggers in der untersten Zeile präsentiert. 

Die obersten vier Zeilen enthalten automatisch den aktuellen Zustand der Daten- und 
Adreßregister. Sie ändern einen Registerwert, indem Sie ihn bei gedrückter Shift-Taste 
doppelklicken. Ein Requester erscheint, mit dem Sie den neuen Wert als beliebigen 
Ausdruck eingeben können. Ferner laden Sie ein Register sofort mit dem zuletzt ange¬ 
klickten Wert, indem Sie seinen Namen doppelklicken. Dies funktioniert mehrfach, so 
daß Sie den Wert hintereinander in mehrere Register schieben können. 

Die fünfte Zeile enthält den Programmzähler PC des nächsten Befehls, der ausgeführt 
wird, sowie die fünf Flags des Prozessor-Condition-Code-Registers. Den PC können Sie 
wie die Register oben ändern, z.B. klicken Sie in einem Disassembler-Fenster die Adresse 
einmal an, bei der die Programmausführung fortgesetzt werden soll, und danach den 
Namen »PC«, so daß der PC auf diese Adresse gesetzt wird. In einem Disassembler- 
Fenster wird der aktuelle PC durch einen Stern vor dem Opcode gekennzeichnet. Die 
Flags ändern Sie durch einen Doppelklick; dabei wird der Zustand des Flags invertiert. 

In der sechsten Zeile wird der Befehl disassembliert, der als nächstes ausgeführt wird. 
Als Kommentar werden die Adressen ausgeben, die sich durch den momentanen Re¬ 
gisterzustand berechnen, sowie bei Verzweigungen und anderen, zustandsabhängigen 
Befehlen TRUE bzw. FALSE abhängig davon, ob die Befehlsbedingung beim momen¬ 
tanen Flagzustand zutrifft. Wenn Sie den Opcode des Befehls doppelklicken, können 
Sie einen anderen Befehl an die PC-Adresse assemblieren (siehe Speicherfenster: Di¬ 
sassembler/Assembler). Beachten Sie jedoch, daß ein neuer Befehl eine andere Länge 
haben und Folgebefehle teilweise überschreiben kann. 

Die siebte Zeile enthält schließlich eine Meldung über den aktuellen Status des Debug¬ 
gers (z.B. ob gerade ein Programm geladen wird oder eine Exception vorkam). 

Bei allen Werten bewirkt ein normaler Doppelklick das Offnen eines Speicherfensters 
mit dem angeklickten Wert als Startadresse. 

4.3.3 Das BigStatus-Fenster 

Dieses Fenster ist im wesentlichen mit dem Statusfenster identisch, hat aber als Er¬ 
weiterung einen Speicherauszug des Bereiches, auf den die Adreßregister zeigen. Dieser 
Auszug umfaßt drei Langworte sowie einen Textblock. Während Sie ein Programm ein- 
zelschrittweise ausführen lassen, können Sie somit beobachten, an welchen Stellen die 
Adreßregister arbeiten und was sich dort befindet. 

Im Gegensatz zu Speicherfenstern werden diese Daten hier nicht automatisch refresht, 
eine Änderung der angezeigten Speicherzellen wird erst sichtbar, wenn das Statusfenster 
selber refresht wird (z.B. nach einem Single-Step). 


4.3.4 Das FPU-Statusfenster 

Das FPU-Statusfenster können Sie nur benutzen, wenn Sie einen Fließkomma- 
Coprozessor vom Typ MC68881 oder MC68882 oder eine MC68040-MPU in Ihrem 
Rechner eingebaut haben. Sollte dies nicht der Fall sein, meldet Ihnen das FPU-Fenster 
dies und verbirgt seine Funktionen vor Ihnen. 

Das Fenster stellt den Inhalt der FPU-Register FPO bis FP7 sowie den Status des 
Coprozessors dar und ermöglicht Ihnen somit, Fließkommaberechnungen zu verfolgen. 
Normale Werte werden normalisiert in Exponentialdarstellung ausgegeben, wobei es 18 
Nachkommastellen und einen vierstelligen Exponenten zur Basis zehn gibt. Darüber¬ 
hinaus gibt es die Werte »inf« für die unechte Zahl »Unendlich« und »NAN« für 
»Not-A-Number« (siehe auch FPU-Handbuch). 

Sie ändern die Fließkommawerte, indem Sie einen Wert doppelklicken, woraufhin ein 
Requester erscheint, in dem Sie den neuen Wert editieren können. Dabei dürfen Sie 
einen beliebigen Fließkomma-Ausdruck benutzen. 

Das Statusregister FPSR können Sie - ebenfalls durch Doppelklick - wie eine normale 
Langwortzahl editieren. Vier Flags dieses Registers werden zudem gesondert dargestellt. 
Diese können Sie durch Doppelklick in ihrem Zustand ändern, dabei paßt sich der Wert 
des FPSR automatisch an. 

4.3.5 Das Hunk-Fenster 

Sofern gerade ein Programm debuggt wird, zeigt das Hunk-Fenster die Segmente des 
Programmes an. Die Anzeige umfaßt den Segment beginn, d.h. die Startadresse, die 
Segmentgröße, dann den Hunknamen (wenn dieser im Programmfile über hunk.name 
oder hunk.unit angegeben ist; meistens nicht vorhanden) und daraufhin eingeklammert 
einen Symbolnamen, der auf der Startadresse liegt. Sowohl der Hunk- als auch der 
Symbolname können fehlen. 

Bei Bedienung des Übernahme-Gadgets wird der Hunk als erster angezeigt, in dem 
die eingegebene Adresse liegt. Gibt es keinen solchen Hunk, dann beept das Display 
einmal. Beim Frage-Requester erfolgt eine Fehlermeldung, und der Requester wird nicht 
verlassen. 

Durch einen Doppelklick wird ein Speicherfenster mit der entsprechenden Startadresse 
geöffnet. Wurde der Hunknaine doppelgeklickt, dann hat das Speicherfenster diesen als 
Fensternamen. 

Bitte beachten Sie, daß es für Tasks, die keine Prozesse sind, keine Segmente gibt und 
das Hunk-Fenster daher leer bleibt. 

4.3.6 Das Symbol-Fenster 

In diesem Fenster werden die Symbole des gerade zu debuggenden Programmes dar¬ 
gestellt. Auf die Symboladresse folgt jeweils der Symbolname. Das Zusatzmenü Order 
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gibt Ihnen die Möglichkeit, die Symbole nach aufsteigenden Adressen oder alphabetisch 
zu sortieren. Dabei hat jedes Symbolfenster seine eigene Sortierung. 

Bei Bedienung des Übernahme-Gadgets wird das Symbol mit der entsprechenden 
Adresse als erstes angezeigt. Gibt es kein solches Symbol, dann beept das Display ein¬ 
mal. Beim Frage-Requester erfolgt eine Fehlermeldung, und der Requester wird nicht 
verlassen. 

Durch einen Doppelklick wird ein Speicherfenster mit der entsprechenden Startadresse 
geöffnet. Bitte beachten Sie, daß das Symbolfenster leer ist, wenn keine Symbole für 
das Programm gefunden wurden, und daß an die lokalen Label des Assemblers eine 
spezielle Kennung zur eindeutigen Identißzierung angehängt ist. 

4.3.7 Das Breakpoint-Fenster 

Die von Ihnen gesetzten Breakpoints (siehe auch Break-Menü) können Sie hier betrach¬ 
ten. Auf die Breakpoint-Adresse folgt das Enable/Disable-Flag (»+« für enabled, »-< 
für disabled), dann ein Zähler, der von Null (oder einem von Ihnen angegebenen Wert) 
hochgezählt wird, bis der Anhaltewert (nach dem >/<) erreicht ist. Tritt ein Break¬ 
point auf, wird der Zähler erhöht und das Programm nur dann unterbrochen, wenn der 
Zähler den Anhaltewert erreicht hat! Falls es ein Symbol für die Breakpoint-Adresse 
gibt, wird dieses auch ausgegeben. 

Bei Bedienung des Übernahme-Gadgets wird der Breakpoint mit der entsprechenden 
Adresse als erster angezeigt. Gibt es kein solches Symbol, dann beept das Display 
einmal. Beim Frage-Requester erfolgt eine Fehlermeldung, und der Requester wird nicht 
verlassen. 

Durch Doppelklick können Sie den Zähler und den Anhaltewert ändern, dabei darf der 
Anhaltewert aber nicht Null sein, und der Zähler muß immer kleiner gleich dem An¬ 
haltewert sein. Doppelklicken auf das Enable/Disable-Flag kehrt dessen Zustand um. 
Durch einen Doppelklick auf die Adresse bzw. den Symbolnamen wird ein Speicherfen- 
st.er mit der entsprechenden Startadresse geöffnet. 

Bei Speicher-Breakpoints gibt es neben den oben erwähnten Ausgaben noch die Größen¬ 
angabe (»B«, »W« oder »L«), die Relation (»——<, »!=«, »< = <, »>=<) und die 
betroffene Speicheradresse. Alle drei sind nicht anklickbar. 

4.3.8 Das History-Fenster 

Die History dient zum Aufzeichnen von Befehlen während der Abarbeitung des zu de- 
buggenden Programmes. Wenn Sie nach Fehlern suchen, geraten Sie oft über den Punkt 
hinaus, an dem das falsche Programmverhalten das erste mal auftritt. Damit Sie das 
Debuggen nicht von vorne beginnen müssen, können Sie über die History verfolgen, 
welche Befehle das Programm ausgeführt hat und welche Registerinhalte zu den jewei¬ 
ligen Zeitpunkten Vorlagen. Die Aufzeichnungstiefe ist einstellbar und die Aufzeichnung 
ein- bzw. ausschaltbar (siehe auch Trace-Menü). Sobald die Aufzeichnungstiefe erreicht 
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ist, weiden die ersten aufgezeichneten Elemente wieder überschrieben. Sie haben da¬ 
mit zwar nur eine Aufzeichnung der letzten x Befehle, die Tiefe ist dafür nur durch 
den verfügbaren Speicher beschränkt. Nach dem Start ist eine Tiefe von zehn einge¬ 
stellt, damit auch Besitzer von Rechnern mit nur 512 KByte die Möglichkeit haben, 
den Debugger zu benutzen. 

Ein History-Element umfaßt einen kompletten Registersatz der MPU (die FPU wird 
aus Platzgründen nicht aufgezeichnet) mit einem PC und der dort stehenden, disassem- 
bliert.en Prozessorinstruktion. Damit Sie Änderungen in den Registern leicht verfolgen 
können, besitzt das History-Fenster kein weiches Scrollen für die Pfeil-Gadgets, sondern 
schaltet jeweils ein komplettes Element weiter. 

Das Übernahme-Gadget übernimmt hier die Nummer eines anzuzeigenden Elementes. 
Sollte die Aufzeichnungstiefe geringer als die angegebene Nummer sein, beept das Dis¬ 
play einmal. Beim Frage-Requester erfolgt eine Fehlermeldung, und der Requester wird 
nicht verlassen. 

Auch hier bewirkt ein Doppelklick das Offnen eines Speicherfensters mit dem ange¬ 
klickten Wert als Startadresse. 

4.3.9 Das Text-Fenster 

Das Text-Fenster wurde geschaffen, damit Sie auch an Information über interne Daten 
des Betriebssystems kommen können. Befehle werden wie in einem CLI-Fenster eingege¬ 
ben, wobei das Editieren wie oben angegeben dem der Intuition-String-Gadgets gleicht. 
Groß- und Kleinschreibung der Befehle ist unwichtig, es sind die folgenden verfügbar: 

? Bietet eine Aufstellung der verfügbaren Befehle, 
d Gibt Liste der Devices aus. 

i Gibt Information über die zu debuggende Task aus. Hängen Sie eine Adresse in 
hexadezimaler Form mit »i SAdressec an, so erhalten Sie die Information über 
die korrespondierende Task mit dieser Adresse. Diese Information umfaßt die 
Daten des Task-Kontrollblocks, der Process- und der CLI-Struktur. Bitte beach¬ 
ten Sie, daß in der Information alle BCPL-Zeiger schon auf Prozessoradressen 
umgerechnet worden sind. 

1 Gibt Liste der Libraries aus. 
p Gibt Liste der Ports aus. 
r Gibt Liste der Resources aus. 
s Gibt Liste der Interruptserver aus. 
t Gibt Liste der Tasks aus. 

Die letzten 64 Zeilen des Fensters werden gepuffert und können über Scrollbar und Pfeil- 
Gadgets wieder sichtbar gemacht werden. Um dann neue Befehle einzugeben, brauchen 
Sie nicht zum Pufferende zu gehen, neue Ausgaben schalten automatisch an das Puf¬ 
ferende und erzeugen dort die neuen Zeilen. Sollte der Cursor zum Eingeben nicht 
sichtbar sein, müssen Sie nur die unterste Textzeile des Fensters anklicken. 



148 _ KAPITEL 4. SYMBOLISCHER DEBUGGER DBUG VI. I 

Das Ubernahme-Gadget hat hier keine Funktion. Durch einen Doppelklick auf einen 
Wert wird ein Speicherfenster mit der entsprechenden Startadresse geöffnet. 

4.3.10 Das Source-Level-Fenster 

DBug bietet auch echtes Source-Level-Debugging. Wenn Sie ein Programm in den De¬ 
bugger laden, das unter Verwendung der Startoption >-c q< des Optimierenden-Makro- 
Assemblers erzeugt wurde, dann erscheint die Sourve-Level-Information, nämlich der 
Quelltext des assemblierten Programmes, in den Source-Fenstern. 

Beim Offnen des Source-Fensters kann eine Adresse angeklickt sein, dann wird automa¬ 
tisch auf die passende Sourcestelle positioniert, sofern es eine für diese Adresse gibt. Das 
Positionieren kann auch über das Übernahmegadget geschehen. Die Adressen vor den 
Quellzeilen sind anklickbar und können zum Speicherfenster-Öffnen bzw. Breakpoint- 
Setzen benutzt werden. Wenn der aktuelle PC die Adresse einer Quellzeile enthält, 
wird diese per Invertieren markiert. Normalerweise wird das Source-Fenster immer mit 
dem aktuellen PC mitgeführt, das kann aber mit Don’t move im Source-Menü ari- bzw. 
abgeschaltet werden. Die Darstellung der Quellzeilen kann Tabulatorzeichen enthalten: 
über Tabulator im Source-Menü kann eingestellt werden, auf welche Tabulatorpositio¬ 
nen diese Zeichen expandiert werden (Default ist 8). Schließlich können noch Strings 
im Quelltext mittels Find string beginnend ab der zweiten sichtbaren Zeile gefunden 
werden. Der Vergleich findet ohne Groß-/Kleinschreibung statt. 

Das Übernahme-Gadget bewirkt, daß die entsprechende Source-Level-Zeile zur Adresse 
gesucht wird. Falls für bestimmte Programmstellen keine Source-Level-Information vor- 
liegt, kann natürlich auch keine im Source-Fenster dargestellt werden. 
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4.4 Debuggen von Tasks 

Mit DBug können Sie beliebige Tasks unter die Kontrolle des Debuggers bringen. DBug 
ermöglicht Ihnen sogar, vom Hauptprogramm abgetrennt laufende Tasks zu debuggen, 
die Sie normalerweise nicht erreichen würden. Wenn Sie den Debugger mehrfach gleich¬ 
zeitig gestartet haben, können Sie sogar Haupt- und Nebentask gleichzeitig debuggen. 
In diesem Kapitel erfahren Sie, auf welche Weise verschiedene Tasks oder Programme 
abgefangen und vom Debugger kontrolliert werden. 

4.4.1 Abfangen der nächstgestarteten Task 

Wollen Sie eine Task abfangen, die von der Workbench oder dem CLI oder einer Shell 
aus gestartet wird, so wählen Sie den Menüpunkt Catch WB/CLI im Project-Menii. 
Falls Sie ein Programm unter einem CLI oder einer Shell unter Kickstart 1.3 benutzen, 
müssen Sie den Programmnamen so weit angeben, daß der Debugger das Programmfile 
von dem Directory aus, von dem er gestartet wurde, finden kann. Ab System 2.Ü ist 
dies nicht mehr notwendig. 

Beachten Sie, daß Sie ein zu debuggendes Programm unter dem CLI oder einer Shell 
nicht mit dem Arm-Kommando starten, da sonst das Arm-Kommando abgefangen wird. 
Ferner können Sie beim Start des Debuggers vom CLI aus gleich ein Programm zum 
Debuggen anwählen, indem Sie die Startzeile des Programms einfach an den Debug¬ 
gernamen anhängen. 

Wollen Sie hingegen die nächste mit der Betriebssystemfunktion AddTask() oder Crea- 
t,eProc() gestartete Task abfangen, dann wählen Sie den Menüpunkt Catch next task im 
Project-Menü. Dabei sollten Sie aber genau wissen, welche Tasks demnächst entstehen, 
sonst erwischen Sie unter Umständen die falsche. 


4.4.2 Abfangen einer bereits laufenden Task 

Gehen Sie in ein Text-Fenster und lassen Sie sich die Taskliste über das »t«-Kommando 
ausgeben. Klicken Sie die Adresse der zu debuggenden Task einmal an und wählen Sie 
den Menüpunkt Select task im Project-Menü. Die Task wird sofort angehalten; wartet 
sie jedoch auf Signale (z.B. auf einen Gadget-Druck), müssen Sie diese Signale von Hand 
auslösen, damit das Abfangen stattfinden kann. Sofern Sie die Taskadresse auswendig 
oder schon aus anderen Quellen wissen, können Sie auch gleich Select task wählen und 
die Taskadresse über den dann erscheinenden Requester eingeben. Wählen Sie keine 
Systemtasks an. da der Rechner sonst abstürzen bziv. verklemmen kann. 


4.4.3 Abfangen einer abgestürzten Task 

Leider ist diese Fähigkeit nur mit Kickstart 1.3 oder kleiner vorhanden, da ab Sy¬ 
stem 2.0 umfangreiche Änderungen vorgenommen wurden, so daß keine nachträgliche 
Abfangmöglichkeit mehr besteht. 
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Machen Sie dies nur, wenn eine Task abgestürzt ist und Sic diese sofort auswählen 
können. Tasks, die ohne Debugger-Kontrolle eine Exception auslösen, werden von Exec 
angehalten, und der DOS-Requester »Software error...< erscheint im Screen der Work- 
bench. 

Sie starten dann den Debugger (oder hatten ihn im Hintergrund) und gehen wie im 
vorigen Abschnitt vor, wählen aber den Menüpunkt Postmortem statt Select task. Nun 
müssen Sie nur noch Cancel im DOS-Requester dieser Task anklicken, und der Debugger 
zeigt Ihnen die Exception und den fehlerhaften Befehl an. Sie sollten unbedingt nach 
Postmortem das Cancel-Gadget klicken, ferner ist es empfehlenswert, nach erfolgter 
Absturzursachen-Suche den Rechner neu zu booten. Es ist allerdings gut möglich, daß 
Sie den Betrieb über Kill task fortsetzen oder das Programm nach Reparatur normal 
beenden können. 

4.4.4 Unterbrechen des Abfangens 

Mit dem Befehl Cancel catching kann jegliches Abfangen abgebrochen werden. 

4.4.5 Nach dem Abfangen 

Sobald DBug eine Task abgefangen hat, versucht er, das Programmfile der Task zu fin¬ 
den. Ist dies möglich, dann lädt er die Symbole des Programmes (diese haben Sie z.B. 
mit dem Optimierenden-Makro-Assembler mit der »-c s«-Startoption erzeugt), evtl, 
die Source-Level-Information (diese bekommen Sie durch OM As Startoption »-c q«) 
und zeigt den als nächstes auszuführenden Befehl in den Statusfenstern an. Sie können 
nun die Variablen und Funktionen der Task mit ihrem symbolischen Namen anspre¬ 
chen (der Disassembler ersetzt dann z.B. Speicheradressen durch symbolische Namen) 
oder gleich die komfortable Source-Level-Ebene benutzen. Falls das Programmfile nicht 
gefunden wird oder dieses keine Symboldefinitionen enthält, meldet der Debugger dies. 
Beachten Sie, daß es möglich ist, mehrere gleichnamige Symbole zu haben, so daß Sie 
mit dem symbolischen Namen unter Umständen die falsche Adresse ansprechen, und 
daß reine Tasks, die kein Prozeß sind, kein Programmfile und daher auch keine Symbole 
besitzen. 

Sie haben außerdem die volle Kontrolle über die Ausführung der Task. Sehen Sie sich das 
Trace-Menü an. Mit Single Step führen Sie den gerade in einem Statusfenster sichtbaren 
Befehl aus und halten das Programm sofort wieder an. Welcher Befehl dies ist, können 
Sie u.a. in einem Disassembler-Fenster erfahren, denn dieser ist dort mit einem Stern 
gekennzeichnet. Trace ca Ms arbeitet ähnlich, führt aber durch BSR oder JSR aufgerufene 
Unterprogramme mit voller Geschwindigkeit aus und hält die Task erst wieder nach 
der Rückkehr aus dem Unterprogramm an. Go läßt die Task normal loslaufen und 
unterbricht sie nur, wenn eine Exception oder ein Breakpoint vorkam. 

Falls Sie ein PC-Disassembler-Fenster geöffnet haben, folgt dieses während der Einzel¬ 
schritte dem aktuellen PC, so daß die gerade zu bearbeitende Stelle immer deutlich 
sichtbar ist. In einem Source-Level-Fenster können Sie sogar gleichzeitig den Quelltext 
ihres Programmes sehen. Auch dort ist der aktuelle PC markiert. 
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Solange eine Task unter Kontrolle des Debuggers läuft, kann sie nicht abstürzen, denn 
es werden die geläufigsten Ausnahmezustände (Exceptions) abgefangen. Der Debugger 
unterbricht einfach das Programm und sagt Ihnen, welche Exception das Anhalten an 
welcher Stelle verursacht hat. Es gibt auch Exceptions (speziell vom Betriebssystem 
verursachte), die sofort zu einem Guru führen. Die folgenden Exceptions werden von 
DBug verarbeitet: 

• Address error 

• Illegal instruction 

• Zero divide 

• CHK, CHK2 

• TRAPV, TRAPcc, cpTRAPcc 

• Privilege Violation 

• Line-A- und Line-F-Emulator 

• alle FPU-Exceptions 

4.4.6 Beenden der Task 

Eine Task beendet sich selber durch ein RTS bei passendem Stackpointer oder durch die 
DOS-Funktion Exit(). Der Debugger druckt eine entsprechende Meldung und blockiert 
weiteres Debuggen, so daß Sie dann eine neue Task anwählen können. Sollte die Task 
an einen Punkt kommen, an dem Sie sie nicht normal beenden können, steht Ihnen 
noch der Befehl Kill task zur Verfügung, der die Ausführung der Task abbricht und 
ihren Code aus dem Speicher entfernt. Von der Task beanspruchte Ressourcen oder 
z.B. Intuition-Windows bleiben dabei allerdings belegt. Dafür können Sie sich eine 
Fluchttür offenlialten, um beispielsweise noch in ein CLI oder eine Shell zu gelangen 
und Dateien auf Platte oder Diskette zu retten. 
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4,5 Die Menüs 

4.5.1 Das Project-Menü 

Catch WB/CLI 

Der Debugger fängt die nächste vom CLI, der Shell oder der Workbench gest¬ 
artete Task ab. Dabei dürfen die CLI-Tasks nicht mit Run gestartet werden, da 
sonst das Kommando Run debuggt wird. Beachten Sie, daß Sie unter Kickstart 
1.3 den Programmnamen so weit angeben, daß der Debugger das Programmfile 
finden kann. Siehe auch Kapitel 4.4. 

Catch next task 

Der Debugger fängt die nächste von der Exec-Funktion AddTask() oder Ort fi¬ 
te Proc() gestartete Task ab. Sie sollten hierbei wissen, welche Tasks demnächst 
entstehen. 

Cancel catching 

Dies bricht das obige Abfangen ab. Sie können sofort wieder Programme ohne 
Kontrolle durch den Debugger starten. 

Select task 

Diese Funktion ermöglicht Ihnen, eine bereits laufende Task zum Debuggen aus¬ 
zuwählen. Dazu klicken Sie die Taskadresse einfach im Textfenster an und wählen 
diesen Meriüpunkt. Die Task wird sofort angehalten, und es wird nach ihren 
Symbolen gesucht. Siehe auch Kapitel 4.4. 

Postmortem 

Diese Funktion arbeitet ähnlich wie Select task, wählt aber eine Task zum Debug¬ 
gen, die bereits mit einem Software-Fehler von Exec angehalten wurde. Wählen 
Sie die Taskadresse und diesen Menüpunkt an und klicken Sie auf Cancel. Der 
Debugger übernimmt die Kontrolle (siehe auch »Debuggen von Tasks«), Leider 
ist dies nur mit Kickstart 1.3 oder kleiner möglich, nicht ab System 2.0. Sie 
sollten unbedingt nur bereits verstorbene Tasks über diesen Menüpunkt anhalten 
und die Anwahl nach Auswahl der Adresse unverzüglich durchführen. 

Leave task 

Gibt, die Kontrolle über die aktuelle Task ab und läßt diese frei loslaufen. Sollte 
nun noch ein Fehler auftreten, kann dieser höchstens noch über Postmortem oder 
Select task in Erfahrung gebracht werden. 

Kill task 

Die abgefangene Task wird einfach beendet und entfernt. Von der Task be¬ 
legte System-Ressourcen u.ä. werden nicht freigegeben, so bleiben z.B. Intuition- 
Windows dieser Task einfach »in der Luft hängen« und geöffnet. Bitte beachten 
Sie, daß Kill task nicht den perfekten Ausstieg aus dem laufenden Programm bie¬ 
tet. Speziell workbench-gestartete Tasks können beim Aufruf dieses Kommandos 
Probleme bereiten, da ihre Workbench-Message nicht beantwortet werden kann. 
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Name log file 

DBug besitzt ein sogenanntes Logfile, in das Ausgaben geschrieben werden 
können. Mit dieser Funktion geben Sie dem Logfile einen Namen. Sobald ein 
Name bekannt ist, kann das Logfile geöffnet werden. Solange es nicht offen ist, 
kann der Name abgeändert werden. Sie können das File auch schließen und ein 
zweites File mit. anderem Namen eröffnen. Der Name darf maximal 127 Zeichen 
lang sein. 

Open log file 

Öffnet, das Logfile mit dem angegebenen Namen. Sollte dies nicht funktionieren, 
beept das Display und informiert Sie so. Beachten Sie, daß die Ausgaben in das 
Logfile an ein evtl, altes, bereits existierendes File angehängt werden. Ein altes 
File gleichen Namens wird also nicht gelöscht! 

Close log file 

Schließt das Logfile, sofern es offen ist. 

Log quiet, Log verbose 

Diese Punkte bewirken das An- bzw. Abschalten von Meldungen während des 
Tracens und Steppens. Die Debugging-Aktionen können damit in dem Logfile 
protokolliert und später in Ruhe analysiert werden. 

Quit 

Beendet den Debugger. Wird gerade eine Task debuggt, dann wird vorher noch 
Kill task ausgeführt. Ist das Logfile noch offen, wird es geschlossen. 

4.5.2 Das Open-Menü 

Dieses Menü öffnet Fenster mit dem angegebenen Typ. Haben Sie einen Wert ange¬ 
klickt, dann wird er automatisch als Startwert für das Fenster genommen, z.B. können 
Sie beim Offnen eines Symbolfensters gleich feststellen, ob es ein Symbol mit der ent¬ 
sprechenden Adresse gibt. 

4.5.3 Das Trace-Menü 

Single step 

Dieser Befehl führt einen Einzelschritt in der zu debuggenden Task aus. Sollte es 
die letzte Programminstruktion vor dem Terminieren sein, dann wird die Task 
beendet und eine entsprechende Meldung ausgegeben. Diese Funktion kann auch 
erreicht werden, indem Sie die Funktionstaste <F1> drücken. 

Wenn das Logfile geöffnet und Log verbose gewählt ist, dann wird eine Proto¬ 
kollzeile in das Logfile gegeben. 

Trace calls 
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Dies funktioniert ähnlich wie Single Step, arbeitet aber durch BSR oder .TSR 
verursachte Unterprogrammaufrufe mit normaler Geschwindigkeit ab und kehrt 
danach zurück. Bitte beachten Sie, daß dies auch für Unterprogrammaufrufe im 
ROM gilt! Die Funktionstaste <F2> wählt diese Funktion ebenfalls an. 

Sollte ein Breakpoint oder eine andere Unterbrechung im Unterprogramm auf- 
treten, dann hält der Debugger automatisch bei der späteren Rückkehr aus dem 
Unterprogramm an. D.h. Sie müssen nicht den Rest der Unterprogrammes nach 
der Unterbrechung einzelschrittweise durchsteppen, sondern können durch Go 
schnell und sicher zurückgelangen. 

Wenn das Logfile geöffnet und Log verbose gewählt ist, dann wird eine Proto¬ 
kollzeile in das Logfile gegeben. 

Skip code 

Liberspringt den aktuellen Befehl ohne Ausführung. Die Funktionstaste <F3> 
wählt diese Funktion ebenfalls an. 

Go 

Arbeitet die Task ab dem aktuellen PC mit normaler Geschwindigkeit ab. Falls 
Sie keine Breakpoints gesetzt haben, fragt der Debugger vorher über einen Re- 
quester, ob Sie tatsächlich loslaufen möchten. Für Go gibt es keine Funktionsta¬ 
ste. Bei Auftreten eines Breakpoints oder einer Exception wird die Task auto¬ 
matisch wieder angehalten. 

Wenn das Logfile geöffnet und Log verbose gewählt ist, dann wird eine Proto¬ 
kollzeile in das Logfile gegeben. 

Eine per Go o.ä. laufende Task kann durch Drücken von <F6> sofort angehal¬ 
ten werden! Allerdings sollten Sie beachten, daß dies mitten im Betriebssystem 
geschehen kann. 

Base register 

Enthält die zu debuggende Task Instruktionen, bei denen Daten relativ zu ei¬ 
nem Adreßregister adressiert werden, dann kann der Symbolname der Daten 
für den Disassembler normalerweise nicht angezeigt werden. Mit dieser Funk¬ 
tion legen Sie jedoch ein Adreßregister 0 bis 7 fest, für das die Adressierungs¬ 
art »offset(An)« durch einen Symbolnamen ersetzt wird. Siehe auch Basereg- 
Modus des Optimierenden-Makro-Assemblers. Achten Sie darauf, daß Sie beim 
Assemblieren von Instruktionen über das Disassembler-Fenster evtl, die Adres¬ 
sierung »Absolut lang« statt »ofFset(An)« wählen. Geben Sie daher bei Pro¬ 
grammen mit benutztem Basereg-Modus die Adressierung für solche Befehle 
immer an, indem Sie den Offset berechnen lassen, z.B. über 

move symbolname-basisadresse(A5) 

Base on, Base off 

Diese beiden schalten die Offsetdarstellung relativ zu einem Adreßregister ein 
oder aus. Siehe Basereg-Modus von OMA. 

History depth 


Die History zeichnet bei Ablauf eines Programmes die abgearbeiteten Befehle 
auf. Mit dieser Funktion wählen Sie, wieviele Befehle maximal aufgezeichnet 
werden. Ist die Füllgrenze erreicht, werden die ersten aufgezeichneten Befehle 
durch neue überlöscht. Sie haben also nur die letzten Befehle zur Verfügung, um 
einen Fehler, den Sie z.B. gerade beim Single-Step verpaßt haben, doch noch zu 
lokalisieren. 

Beachten Sie, daß die Ausführungszeit bei Go erheblich ansteigt, solange die 
History eingeschaltet ist. 

History on, History off 

Die Befehle schalten die History an oder aus. Einschalten kann auch durch die 
Funktionstaste <F4>, Ausschalten durch <F5> erreicht werden. 

4.5.4 Das Break-Menü 

Set 

Setzt einen Breakpoint. Breakpoints verursachen das Anhalten des zu debug- 
genden Programmes, sobald es auf den Breakpoint stößt. Dann können Sie sich 
z.B. Variablen angucken und auf ihren Zustand überprüfen. Ist ein Wert ange¬ 
klickt, wird der Breakpoint auf diesen gesetzt, sonst fragt ein Requester nach 
der Adresse zum Anhalten. Normale Breakpoints müssen auf geraden Adressen 
liegen. Gibt es den angegebenen Breakpoint schon, beept das Display einmal. 

Set memory 

Setzt Speicher-Breakpoints. Diese speziellen Breakpoints ermöglichen Ihnen, das 
Programm anzuhaltcn, wenn eine oder mehrere Speicherzellen bestimmte Bedin¬ 
gungen erfüllen. 

Auf den Befehl Set memory erscheint ein Requester, in dem eine Adresse einge¬ 
geben oder vor Aufruf angeklickt werden kann. Die Bedingung kann LTngleich 
»!=«, Gleich »—=«, Kleiner Gleich »<=« oder Größer Gleich »>=« sein. 
Ferner müssen der entsprechende Vergleichswert und die Speicherzellengröße 
(1, 2, oder 4 Bytes) angegeben werden. Beispiel: Es soll angehalten werden, 
wenn die Wort-Variable »Zaehler« den Wert fünf erreicht hat. Eingabe: Adresse 
»Zaehler«, Condition »==5«, Size »2«. 

Bitte beachten, daß das Programm erheblich langsamer abgearbeitet wird, sofern 
enablete Speicher-Breakpoints existieren, und daß ein Speicher-Breakpoint nach 
dem ersten Mal immer wieder auslösen kann, solange die Bedingung zutrifft, 
also sollte er gleich nach Anhalten gelöscht oder disabled werden. 

Clear 

Arbeitet wie Set, nur wird ein Breakpoint gelöscht. Gibt es den angegebenen 
Breakpoint nicht, dann beept das Display einmal. 

Enable, Disable 
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Schalten einen Breakpoint vorübergehend ein bzw. aus. Auch hier erscheint ein 
Requester, wenn Sie keinen Wert angeklickt haben. Das Ausschalten eines Break¬ 
points bedeutet nur, daß er das Programm nicht anhält. Sobald er wieder ena- 
bled wird, löst er aus. Deswegen können Sie einen Breakpoint setzen, disablen, 
und das Programm laufen lassen. Während es läuft, können Sie den Breakpoint 
wieder enablen, und das Programm wird erst danach sofort bei Erreichen des 
Breakpoints angehalten. Sie können also Routinen austesten, ohne immer wieder 
anzuhalten, und stoppen nur bei Fehlverhalten. 

Das Ein- und Ausschalten läßt sich auch durch Doppelklicken des Enable-Flags 
im Breakpoint-Fenster bewerkstelligen. 

4.5.5 Das Command-Menü 

Für alle Funktionen wird der gerade angeklickte Wert in das erste Datenfeld übernom¬ 
men. Alle Funktionen prüfen die Eingabewerte und melden Fehler, falls nötig. 

Calculator 

Öffnet ein Hilfsfenster zum Ausrechnen von Ausdrücken. Das Ergebnis wird 
normalerweise als Hexzahl ausgegeben, kann aber in anderen Zahlensystemen 
ausgegeben werden. Zusammenhang zwischen Ausdrucksform und Ausgabefor¬ 
mat: 

#(ausdruck) gibt Ergebnis als Dezimalzahl aus 
$(ausdi'uck) gibt Ergebnis als Hexadezimalzahl aus 
%(ausdruck) gibt Ergebnis als Binärzahl aus 

Search 

Dies öffnet den Such-Requester. Mit diesem können Sie Speicherwerte oder auch 
Strings suchen. Dazu müssen Sie Start- und Endadresse, den Such wert, eine 
Maske (Sie können also auch nach einzelnen Bit-Konstellationen suchen), die 
Größe des Wertes (1, 2 oder 4 Bytes) sowie die Schrittweite angeben. Geben 
Sie als erstes Zeichen ein Gleichheitszeichen beim Suchwert an, so können Sie 
dahinter einen String angeben, nach dem gesucht werden soll. Dieser wird aller¬ 
dings in Abhängigkeit von Groß- und Kleinschreibung gefunden; Mask-, Step- 
und Size-Paraineter werden dann ignoriert. 

Wird eine Stelle gefunden, wird sie ausgegeben, die Startadresse entsprechend 
weitergestellt und aktiviert. Die Fundadresse können Sie doppelt anklicken und 
damit ein Speicherfenster öffnen. Das Weitersuchen lösen Sie durch Drücken von 
Return oder Anklicken von »Ok« aus. Gibt es keine weitere Stelle, meldet der 
Debugger dies und aktiviert die Endadresse. 

Compare 

Vergleicht zwei Speicherbereiche miteinander, sobald Sie Startadresse, End¬ 
adresse und die Vergleichsadresse angegeben haben. Unterschiedliche Stellen 
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werden wie bei Search mit ihrer Adresse ausgegeben und haben ebenfalls den 
Doppelklick zum Öffnen von Speicherfenstern. 

Copy 

Kopiert einen Speicherbereich an eine andere Stelle. Hier werden Startadresse, 
Länge und die Zieladresse benötigt. 

Fill 

Füllt einen Speicherbereich mit einem Wert, der 1, 2 oder 4 Bytes groß sein 
kann. 

Define Symbol 

Dieser Befehl ist nur bei gewählter Debug-Task erreichbar und definiert ein neues 
Symbol, welches an der angegebenen Adresse noch nicht existieren darf. Es darf 
aber ein gleichnamiges Symbol an anderer Stelle geben. 

Define hunk 

Definiert einen neuen Hunk. Dieser bekommt den Namen »SelfmadeN« mit N 
als Nummer des N-ten, selbstdefinierten Hunks. Dies bietet Ihnen die schnelle 
Möglichkeit, während des Debuggens an Zusatzspeicher zu gelangen. 

Log data 

Hiermit können Sie einen Hex-Dump wie mit einem Speicherfenster in das Log- 
file geben. Die Daten sind immer ein Langwort groß und haben immer den 
Textblock. Während des Schreibens ändert sich die Mauszeiger-Gestalt, und der 
automatische Refresh usw. des ganzen Debuggers ist abgeschaltet, damit die 
File-Operation so schnell wie möglich beendet werden kann. 

Log assembly 

Arbeitet wie Log data, nur wird ein Disassembler-Listing des angegebenen Be¬ 
reiches in das Logfile geschrieben. 

4.5.6 Das Window-Menü 

Freeze 

Dieser Befehl friert ein Speicher- oder Statusfenster ein. Der Zustand der Fen¬ 
steranzeige wird dann nicht mehr aktualisiert, d.h. der automatische Refresh 
wird für dieses Fenster ausgeschaltet. Dies können Sie verwenden, um Änderun¬ 
gen während der Programmausführung zu verfolgen. 

Andern der Fenster-Größeneinstellung oder des Anzeigebereiches bewirken trotz 
Einfrierens einen einmaligen Anzeigerefresh. 

Warm 

Taut ein Fenster wieder auf. Es wird sofort auf den neuen Zustand gebracht und 
unterliegt wieder dem automatischen Refresh. 

Update 
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Dient dazu, eingefrorene Fenster trotzdem zu refreshen. Dieser Refresh erfolgt 
nur auf Anwählen von Update und z.B. bei Ändern der Fenstergröße. Um z.B. 
Momentaufnahmen von veränderlichen Speicherzellen zu machen, können Sie 
das entsprechende Speicherfenster einfricrcn und immer wieder Update wählen. 
Speziell bei schnell veränderlichen Zellen wären Sie sonst nicht in der Lage, die 
Werte abzulesen. 

Duplicate 

Dieser Befehl dupliziert das aktuelle Fenster. Eine genaue Kopie des Fensters mit 
den Einstellungen des alten erscheint exakt über dem alten Fenster. Das neue 
Fenster bekommt den Namen »Copy of Name«, wobei »Name« der Name des 
alten Fensters ist. 


Hiermit können Sie dem aktuellen Fenster über einen Fragerequest.er einen neuen 
Titel geben. 

Log du mp 

Dies schreibt den Inhalt des aktuellen Fensters in das Logfile, wenn dieses offen 
ist. Während des Schreibens ändert sich der Mauszeiger, und der automatische 
Refresh usw. des ganzen Debuggers ist abgeschaltet. 

Front, Back 

Diese beiden legen das aktuelle Fenster in den Vorder- bzw. Hintergrund. 

Smart refresh? 

Ab Kickstart 2.0 ist hiermit wählbar, ob Fenster mit SIMPLE_REFRESH oder 
SMART.REFRESH laufen. Diese Einstellung wird im durch Save context erzeug¬ 
ten File mit abgespeichert. Der Wechsel kann vollzogen werden, während der De¬ 
bugger läuft. Dadurch sind gleichzeitig Fenster mit hoher Refreshgeschwindigkeit 
bzw. mit niedrigem Speicherverbrauch (für Grafikkarten und Großbildschirme) 
möglich. Das jeweils nächste zu öffnende Fenster bekommt den Refresh, der im 
Window-Menü eingestellt ist. Leider ist diese Fähigkeit wegen eines 1.3-ROM- 
Fehlers erst ab 2.0 nutzbar. 

Save context 

Diese Funktion schreibt die Einstellungen der momentan offenen Debugger- 
Fenster in ein File namens DBug.prefsin das beim Debugger-Start eingeschaltete 
Directory. Wenn der Debugger erneut gestartet wird, liest er dieses File und öff¬ 
net die Fenster genau so, wie in DBug.prefs abgespeichert. Dies dient dazu, den 
Debugger für immer wiederkehrendes Debuggen eines Ihrer Projekte weitgehend 
zu initialisieren. 

4.5.7 Das Order-Menü 


(nur für Symbol-Fenster) 
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Address, Alphabetic 

Nur einer dieser Menüpunkte kann eingeschaltet sein. Sie bestimmen, ob die 
Symbole eines Symbolfensters alphabetisch oder nach aufsteigender Adresse sor¬ 
tiert sind. 

4.5.8 Das Source-Menü 

(nur für Source-Fenster) 

Move with PC, Don’t move 

Diese beiden Menüs beschreiben im Wechsel, ob der Inhalt des Source-Fensters 
dem aktuellen PC beim Single-Step folgen soll oder nicht. 

Find string 

Mit diesem Befehl kann ein String innerhalb des Quelltextes im Source-Fenster 
gesucht werden. Wenn der String gefunden wird, positioniert der Debugger 
die entsprechende Zeile als oberste, sichtbare des Source-Fensters. Gesucht 
wird ab jeweils der zweiten sichtbaren Zeile. Der Vergleich findet ohne Groß- 
/Kleinschreibung statt. 

Tabulator 

Hiermit wird der Tabulatorenabstand innerhalb des Quelltextes angewählt, da¬ 
mit Sie die richtige Source-Darstellung erhalten. Defaultmäßig ist dies 8. 

4.5.9 Das Address-Menü 

(nur für Speicherfenster) 

Hunk ränge 

Wählt als Speicherfenster-Bereich den Bereich des Hunks, in dem die aktuelle 
Startadresse liegt. Sofern die Adresse in keinem Hunk vorkommt, wird Physical 
ränge genommen. 

Physical ränge 

Wählt den physikalischen Prozessorbereich. Dieser ist 0 bis SFFFFFF für 
MC68000 und MC68010 bzw. 0 bis SFFFFFFFF für MC68020 und höhere Pro¬ 
zessoren, allerdings eingeschränkt durch den tatsächlich vorhandenen Speicher 
und die Dateien DBug.memory. Siehe auch Abschnitt 4.3.1. 

Absolute ränge 

Hier können Sie über Fragerequester einen beliebigen Bereich für das Speicher¬ 
fenster angeben. 

Symbols on, Symbols ofF 

Damit bestimmen Sie, ob Symbolzeilen zwischen die Datenzeilen eingeschoben 
werden oder nicht. 
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No ofFset 

Dies druckt die Speicheradresse als hexadezimale Zahl. 

Symbol ofFset 

Dies druckt als Adresse den Abstand zum vorigen Symbol im aktuellen Hunk. 
Gibt es dieses nicht, wird der Abstand zum Bereichsanfang ausgegeben. 

Range ofFset 

Dies druckt als Adresse den Abstand zum Bereichsanfang. 

Add address, Suppress address 

Die beiden Befehle geben an, ob die Speicheradresse als hexadezimale Zahl ein¬ 
geklammert hinter den OfFset gedruckt wird, oder ob sie weggelassen werden 
soll. 

Hexadecimal ofFset, Decimal ofFset 

Wählt eine hexadezimale bzw. dezimale Zahl für die Offsetdarstellung. 


4.5. DIE MENÜS _ 161 

Diese drucken die Daten ohne bzw. mit Vorzeichen. Binärzahlen sind immer 
vorzeichenlos. 

Text on, Text ofF 

Bestimmt, ob ein Textblock hinter den Daten folgt. 

Auto width, Specify width 

Normalerweise kommen so viele Daten in ein Speicherfenster, wie ohne Lesever¬ 
lust dargestellt werden können (minimal ein Datum); diese Einstellung ist Auto 
width. Mit Specify width können Sie nun eine feste Anzahl an Daten pro Zeile 
festlegen. Die Anzahl 0 schaltet Auto width ein. 


4.5.10 Das Data-Menii 

(nur für Speicherfenster) 

Disassembler 

Hiermit schaltet Sie die Darstellung auf den Disassembler. Bitte beachten Sie, 
daß die übrigen Befehle des Data-Menüs keine Auswirkung haben, solange der 
Disassembler-Modus eingeschaltet ist. Ausnahme davon sind Unsigned und Si- 
gned, die zwischen vorzeichenloscr bzw. -behafteter Darstellung bei manchen 
Befehlen wie MOVE, ADD, SUB, CMP etc. umschalten. 

PC-Disassembler 

Dies schaltet ebenfalls auf den Disassembler, nur folgt der Fensterinhalt beim 
Tracen dem aktuellen PC. 

Hexadecimal 

Wählt die Darstellung mit hexadezimalen Daten. 

Decimal 

Wählt die Darstellung mit dezimalen Daten. 

Binary 

Wählt die Darstellung mit binären Daten. 

Byte, Word, Long 

Diese wählen die Operandengröße. 

Unsigned, Signed 
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Kapitel 5 


DLink VI.2 


5.1 Einführung 

Ein Linker hat die Aufgabe, aus mehreren Modulen bestehende Programmteile mit¬ 
einander zum fertigen Programm zu verbinden. Dabei können auch in Bibliotheken 
(Libraries) ausgelagerte Codefragmente in das Programm eingebunden werden. 

DLink ist weitgehend kompatibel mit ALink, dem Amiga-Standardlinker. Er verarbeitet 
Objektfiles und Libraries im Amiga-DOS-Hunkformat und unterstützt die Produktion 
von sehr kurzen Programmfiles sowie das »Small-Data-Modell« des Optimierenden- 
Makro-Assemblers. DLink ist ein Linker, der die Objektfiles nur einmal liest und Li¬ 
braries nur einmal durchsucht. Daraus resultiert eine hohe Geschwindigkeit, wobei der 
Linkerlauf praktisch nur so lange wie das Laden der Objektfiles und Libraries und das 
Schreiben des fertigen Programmes dauert. 

DLink ist sparsam mit Speicher, aber für größere Programme (größer 60 KByte) muß 
genügend Speicher verfügbar sein. 

Zum Verstehen der genaueren Arbeitsweise von DLink sollte Ihnen das Hunkformat von 
Amiga-DOS bekannt sein. Ferner empfehle ich, die verschiedenen Optionen des Linkers 
einfach auszuprobieren, insbesondere Map- und Cross-Referenz-File. 

Bisherige Beschränkungen: 

• DLink unterstützt keine Overlays. Für solche seltenen Fälle können Sie den 
Commodore-Linker alink verwenden, der sich im tools-Directory befindet. 

• Symbol- oder Hunk- o.ä. Namen dürfen nicht länger als 1020 Zeichen sein. 

• DLink leitet keine allgemeinen Debug-Hunks an das Zielfile weiter, da das For¬ 
mat von Debug-Hunks nicht genügend standardisiert ist. DLink unterstützt 
aber die Debug-Hunks des Optimierenden Makro-Assemblers für Source-Level- 
Debugging. 

t DLink verarbeitet keine »hunk_common« und kennt keine residenten Libraries. 
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5.2 Aufruf des Linkers 

DLink kann nur über einen CLI-Aufruf gestartet werden. Die CLI-Parameter gehor¬ 
chen den CLI-Konventionen, d.h. der String »a**b« ergibt den Filenamen »a,*b«. Die 
Syntax lautet: 

DLink [FR0M|R00T] Fil es TO Programm [Hauptoptionen] 

Files sind Objektfiles, die in jedem Fall in das Zielprogramm kommen. Diese Filenamen 
dürfen durch FROM oder ROOT eingeleitet werden und können durch Leerzeichen, 
Pluszeichen oder Kommata getrennt werden. Soll ein Filename Leerzeichen, Pluszei¬ 
chen oder Kommata enthalten, muß er alleine und in doppelte Hochkommata eingefaßt 
stehen. Filenamen, die nicht durch eine der folgenden Hauptoptionen eingeleitet werden, 
gelten auch als Objektfiles. Es muß mindestens ein Objektfile angegeben werden; die 
Objektfiles werden in der Reihenfolge in das Programm gebunden, in der sie angegeben 
werden. Deswegen sollten Sie das Objektfile mit der ersten auszuführenden Instruktion 
des Programmes als erstes angeben, da sonst evtl, die Ausführung in z.B. einer Data- 
Sektion beginnt. Es können beliebig viele Objektfiles angegeben werden (auch durch 
das Withfile, s.u.). 

Die TO-Option mit dem darauf folgenden Programmnamen muß angegeben werden, 
damit der Linker weiß, welches Programm erzeugt werden soll. 

Gültige Hauptoptionen sind: 

WITH Withfile 

Mit dieser Option werden weitere Optionen aus dem Textfile Withfile gelesen, 
welche mit den Optionen der CLI-Aufrufzeile gemischt werden. Es ist nicht 
möglich, z.B. die VER-Option doppelt Vorkommen zu lassen (einmal in der Auf¬ 
rufzeile, einmal im Withfile). Nur Libraries dürfen mehrfach Vorkommen, und es 
dürfen mehrere Objektfiles angegeben werden, wobei aber kein Name mehrfach 
erlaubt ist. Eine Wit.hfile-Zeile darf maximal 254 Zeichen lang sein, das Withfile 
hat aber keine Größenbeschränkung. Ein Withfile hat folgende Syntax, wobei 
einige Optionen weggelassen werden dürfen, die WITH-Option nicht erlaubt ist 
und auch mehrere Optionen in einer Zeile stehen dürfen: 

[FR0M|R00T] files 

TO Programm 

VER file 

LIB library 

MAP file 

XREF file 

WIDTH n 

SMALL 

STAT 

STRIP 

SHORT 

VER Meldungsfile 
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Normalerweise gehen alle Meldungen des Linkers auf das Terminäl (das aktuelle 
CLI-Fenster). Mit dieser Option werden die Textausgaben auf das File Meldungs¬ 
file umgeleitet. 

LIBRARY Library[(" ,"|"+")Library2]... 

LIB Library 

Es werden Libraries angegeben, die auf Werte durchsucht werden, die nicht in 
den Objektfiles definiert wurden. Findet DLink in der Library ein verlangtes 
Symbol, wird die entsprechende »liunk_unit« in das fertige Programm einbezo¬ 
gen und so die Referenz aufgelöst. Es können mehrere Libraries durch Pluszei¬ 
chen oder Kommata getrennt angegeben werden. Soll ein Libraryname Pluszei¬ 
chen oder Kommata enthalten, muß er alleine und in doppelte Hochkommata 
eingefaßt stehen. Die LIB-Option darf mehrfach Vorkommen. Die Libraries wer¬ 
den in der Reihenfolge durchsucht, in der sie angegeben sind. Dies ist wichtig 
für Libraries, die dieselben Routinennamen verwenden, bei denen die Routinen 
aber unterschiedliche Fähigkeiten haben. 

Es können beliebig viele Libraries angegeben werden. Eine CLI-Zeile darf zwar 
nicht länger als 255 Zeichen sein, aber per Withfile werden Ihnen keine Ein¬ 
schränkungen auferlegt. 

MAP Mapfile 

Mit dieser Option produzieren Sie am Ende des Linkerlaufes ein Textfile namens 
Mapfile, das für jede eingebundene Sektion Informationen darüber enthält, wel¬ 
che Symbole die Sektion für den Linker sichtbar gemacht hat und welchen Wert 
jedes Symbol hat. Absolute Symbole sind mit einem Stern gekennzeichnet. 

Obwohl Symbolnamen bis zu 1020 Zeichen lang sein dürfen, werden im Map- 
und auch im Cross-Referenz-File maximal 32 Zeichen ausgegeben. 

XREF Crossreferenzfile 

Diese Option funktioniert ähnlich wie MAP, nur wird hier statt des Symbolwer¬ 
tes für jede Sektion und jedes Symbol aufgeführt, wo es von anderen Sektionen 
verlangt wurde. Diese Information umfaßt die Hunknummer innerhalb des fer¬ 
tigen Programmes und den Offset innerhalb dieses Hunks. Mittels der Cross- 
Referenz können z.B. Symbole erkannt werden, die überhaupt nicht benutzt 
werden. 

WIDTH n 

Der Wert legt für das XREF-File fest, wieviel Zeichen eine Zeile maximal ent¬ 
halten darf. Der Wert n muß im Bereich 50 bis 255 liegen. 

SMALL 

Schaltet den Small-Modus ein (nicht dasselbe wie das Small-Data-Modell). Da¬ 
mit kommen alle Code-Hunks in einen Code-Hunk, ebenso alle Data-Hunks in 
einen Data-Hunk und alle Bss-Hunks in einen Bss-Hunk unabhängig vom durch 
»hunk_na,me< definierten Namen. Es werden nur Hunks mit gleichem Spei¬ 
chertyp vereinigt; z.B. wird ein Code-Hunk mit PUBLIC-Speichertyp nicht mit 
einem Code-Hunk mit CHIP-Speichertyp zusammengepackt. 
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STAT 

Gibt nach dem Linkerlauf eine Statistik aus. Diese umfaßt die für den Lauf 
benötigte Zeit und den maximalen Speicherbedarf. 

STRIP 

Mit dieser Option erzeugt DLink das fertige Programm ohne die Symboltabelle 
(ohne »hunk_symbol«). Debug-Hunks außer denen, die OMA selber erzeugt, 
erscheinen grundsätzlich nicht im Zielprogramm, da deren Format nicht genormt 
ist und bei verschiedenen codeerzeugenden Programmen ganz anders aussehen 
kann. 

SHORT 

Diese Option ermöglicht das »Small-Data-Modell« für in Modnle getrennte Pro¬ 
gramme. Siehe Kapitel »Sliort-Modus«. 

NOCASE 

Diese Option bewirkt, daß DLink bei Symbolnamen keine Unterscheidung zwi¬ 
schen Groß- und Kleinschreibung macht. Dies werden Sie benötigen, wenn Sie 
die >-c c«-St,artopt,ion des Assemblers benutzen, da sonst Namen in Libraries 
nicht mit den angeforderten Symbolnamen übereinstimmen. 

Der Linker kann jederzeit mit <Ctrl> + <C> angehalten werden. Die Fehlermeldungen 
von DLink sind präzise und bedürfen keiner Erläuterung. Eine Ausnahme bildet der 
Fehler »Inkompatible Körpertypen«, der dann gemeldet wird, wenn bei zwei verschie¬ 
denen Sektionen die Namen übereinstimmten, der Speichertyp und/oder der Sektions¬ 
typ aber nicht übereinstimmten. 

Deispielaufrufe: 

DLink a.obj b.obj TO prg 
DLink a.obj+b.obj to prg 
DLink a.obj,b.obj to prg 

Linkt a.obj und b.obj zu dem Programm prg. 

DLink WITH Withfile 

Und Withfile enthält 

a.obj b.obj (Zeile 1) 

TO prg (Zeile 2) 

Linkt a.obj und b.obj zu dem Programm prg. 

DLink a.obj+b.obj "c.obj" to "Pro 1" 

Linkt a.obj, b.obj und c.obj zu dem Programm Pro 1. 

DLink a.obj b.obj LIB amiga.lib TO prg STRIP 

Linkt a.obj und b.obj zu dem Programm prg. holt evtl. Teile aus der Librarv 
amiga.lib und verhindert, daß prg eine Symboltabelle hat. 
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DLink a.obj,b.obj lib amiga.lib+debug.lib to prg strip 

DLink a.obj,b.obj lib amiga.lib library "debug.lib" to prg strip 

Wie voriges Beispiel, nur wird die Library debug.lib auch durchsucht, 
dlink a.obj+b.obj to prg map * 

Linkt und erzeugt ein Mapfile, welches auf das Terminal geht. 

5.3 Short-Modus 

Zur Verdeutlichung der Problematik eines »Small-Data-Modell«s bei getrennten Mo¬ 
dulen sei hier auf das Kapitel »Verkürzte Adressierung« des Assembler-Handbuches 
verwiesen. 

Normale Linker können keine 16-Bit-Referenz auf ein Symbol lösen, das nicht zur glei¬ 
chen Sektion gehört, und erzeugen eine Fehlermeldung. Mit der SHORT-Option des 
DLink wird korrekt gelinkt, falls der resultierende 16-Bit-Wert nicht außerhalb seines 
Bereiches gerät und das Symbol zu einer Bss-Sektion gehört. DLink sorgt automatisch 
für einen Offset für eine 64 KByte große Datensektion, indem er 32768 von dem Off¬ 
set abzieht . Es wird also immer angenommen, daß der Basiszeiger auf den Beginn der 
Datensektion plus 32768 zeigt. 

Der Short-Modus funktioniert auch, wenn mehrere Objektfiles Teile ein und derselben 
Bss-Sektion enthalten, solange die Basisadresse in dem Objektfile definiert wird, das als 
erstes von diesen Objektfiles in der Aufrufzeile steht. Für das folgende Beispiel lautet 
der Linkeraufruf 


DLink a.obj 

File a.asm: 

b.obj c.obj to prg 

SHORT 

CODE 

XREF 

basis,wertl,wert2 


lea 

basis+32768,a5 

; Initialisierung des Basiszeigers 

move 

dO,wertl(a5) 

; wird zu MOVE DO,-32764(A5) 

move 

rts 

END 

File b.asm: 

d0,wert2(a5) 

; wird zu MOVE DO,-32760(A5) 

BSS 

XDEF 

basis,wertl 


basis ds.l 

1 


wertl ds.l 

END 

File c.asm: 

1 
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BSS 

XDEF wert2 
wert2 ds.l 1 
END 

5.4 Libraries 

Libraries sind Sammlungen von Objektfiles. Sie werden mit der LIB-Option des Linkers 
durchsucht, und DLink holt nur solche Objektfiles aus der Library, die Definitionen 
enthalten, die noch im Linkerlauf benötigt werden. Diese Definitionen können Routinen 
oder absolute Konstanten sein. 

Sie können eigene Libraries herstellen, indem Sie ganz normale Objektfiles mit 
Konstanten-Definitionen und/oder Routinen per Assembler erstellen, die jeweils min¬ 
destens ein Symbol mit der Assembler-Direktive XDEF für den Linker sichtbar machen. 
Diese Objektfiles brauchen Sie dann nur mit dem (JLI-Befehl JOIN zu einem File, der 
Library, zu vereinigen. Eine Library kann aus nur einem Objektfile bestehen. 

Wenn Sie Konstanten oder Routinen aus einer Library in ihre Programme einbinden 
möchten, geben Sie die Library beim Linkeraufruf mit der LIB-Option an. Der Linker 
wird dann nur die Objektfile-Teile aus der Library in das fertige Programm über¬ 
nehmen, die Symbole definieren, welche Sie in ihren Programmen mit der Assembler- 
Direktive XREF verlangen. 

Da eine Library von vorn bis hinten durchsucht wird, sollten Sie dafür sorgen, daß 
Library-Teile, die Konstanten aus derselben Library benötigen, so weit wie möglich am 
Anfang der Library stehen. Sonst kann folgendes passieren: Das Symbol »Multi« wird 
in der Library definiert, der Linker beachtet dieses Symbol aber vorerst nicht, weil es 
noch nicht verlangt wurde. Weiter hinten in der Library steht eine Routine, die verlangt 
wird und die selber das Symbol »Multi« benötigt. Diese Routine wird eingebunden, 
und das Symbol »Multi« wird als benötigt vermerkt. Da der Linker aber über die 
Definitionsstelle von »Multi« hinaus ist, wird er einen Fehler erzeugen, da er »Multi« 
nicht mehr findet. Einzige Abhilfe wäre das zweimalige Durchsuchen der Library durch 
zweimaliges Angeben per LIB-Option (was aber Zeit kostet). Deswegen sollten Sie beim 
Aufbau ihrer eigenen Libraries auf diese Problematik achten. 

Im Examples-Directory der Originaldiskette finden Sie den kompletten Quelltext der 
mitgelieferten, »amiga.lib«-kompatiblen Library »OMA.lib« mitsamt den nötigen 
Makefiles. Hier sehen Sie sehr genau, wie eine Library aufgebaut werden kann und 
wie sie mittels »Make« aktualisiert gehalten wird. Wenn Sie diese Library abändern 
möchten, dann kopieren Sie die Quelltexte mitsamt Unterdirectories auf eine freie Dis¬ 
kette und fügen die notwendigen OBJ-Unterdirectories hinzu. Danach brauchen Sie 
nur noch im Haupt-Directory der Library zu sein und »make« aufzurufen (arbeiten 
Sie nicht mit der Originaldiskette), um zu der geänderten Version zu kommen. 

Wenn Sie eine Library als Objektfile beim Linken angeben, werden alle Teile der Library 
in das erzeugte Programm eingebunden. Dies können Sie z.B. nutzen, indem Sie mehrere 
Objektfiles per JOIN Zusammenhängen und später als ein einziges File beim Linken 
benutzen. 


Kapitel 6 

Hilfsprogramme und die 
Library OMA.lib 

Sämtliche hier dokumentierten Hilfsprogramme können Sie nur vom CLI aus benutzen. 
Für jedes Hilfsprogramm wird die CLI-Startsyntax genau beschrieben. 


6.1 Make 

Make ist ein Make-Utility, mit dem Programmpakete halbautomatisch auf dem neue¬ 
sten Stand gehalten werden können, solange die Systemuhr richtig eingestellt ist. Die 
Funktion des Make-Utilities ist im Handbuch zum Editor beschrieben, bitte lesen Sie 
dort nach. Die CLI-Syntax lautet: 

MAKE [Filename] 

Filename ist ein optionaler Name für das dem Makelanf zugrunde liegende Makefile. 
Lassen Sie Filename weg, dann benutzt Make den Namen makefile. Im Gegensatz zum 
im Editor integrierten Make-TJtility kann das Makefile mit dem eigenständigen Make- 
Hilfsprogramm also einen anderen Namen als makefile haben. Zudem läßt sich Make 
dann auch mit kleinen 512-KByte-Hauptspeichern betreiben. Beispiel-Makefiles finden 
Sie im Examples-Directory. 


6.2 Absolute 

Absolute ist ein Hilfsprogramm, das aus einem ausführbaren Amiga-DOS-Programm 
ein absolutes Programm erzeugt, welches Sie z.B. in ein EPROM brennen können. Die 
CLI-Syntax lautet: 
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ABSOLUTE Quellfile [TO] Zielfile SAdresse 
ABSOLUTE Quellfile QUERY 

Quellfile ist das ausführbare Amiga-DOS-Programm, das umgewandelt werden soll, und 
Zielfile d as von Absolute erzeugte EPROM-fähige Programm. Der Parameter TO vor 
Zielfile ist optional, darf also weggelassen werden. SAdresse ist die Startadresse für 
das EPROM-Programm, z.B. SFCOOOO für den Amiga-ROM-Beginn. Bei der zweiten 
Syntax werden Sie für jeden Hunk gefragt, in welches Zielfile er gelangen soll und welche 
Startadresse für diesen Hunk benutzt werden soll. Damit ist es möglich, ein Programm 
an mehrere verschiedene Speicherstellen zu legen. Beachten Sie, daß jeder Hunk damit 
in ein eigenes File gelangt, damit er an seine Zieladresse geladen werden kann. Sie 
können Absolute auch dazu mißbrauchen, vom Assembler erzeugte Binärtabellen aus 
dem Amiga-DOS-Hunkformat herauszutrennen und per INCBIN-Direktive in andere 
Quelltexte einzuschließen. Dazu sollten die Tabellen aber nur absolute Daten enthalten, 
da. die Relokationsinformation verloren geht. 


6.3 Strip 

Strip ist ein Programm, das aus Objektfiles, Libraries oder fertigen Programmen die 
Debug-Hunks und Symboltabellen entfernt. Die CLI-Syntax lautet: 

STRIP Quellfile [TO] Zielfile 

Quellfile ist das Objektfile, die Library oder das fertige Programm, und Zielfile ist das 
von Strip erzeugte File ohne die Debug-Hunks und die Symboltabellen. TO ist optional. 

Für Strip ist der Assembler-Quelltext im Examples-Directory unter dem Namen 
Strip. asm enthalten. Das Makefile für Strip steht dort unter dem Namen makefile. 


6.4 Cmp 

Cmp vergleicht zwei Binärfiles miteinander und meldet, ob und wo sie verschieden sind. 
Die CLI-Syntax lautet: 

Cmp Filel File2 

Wenn beide Files gleich sind, wird nichts gemeldet. Der Assembler-Quelltext für Cmp 
ist im Examples-Directory unter dem Namen Cmp.asm enthalten. 


6.5 CLS 

CLS löscht das aktuelle CLI-Fenster. Der Assembler-Quelltext. ist im Examples- 
Directory unter dem Namen CLS.asm enthalten. 
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6.6 Das Include-Directory 

Das Directory Include enthält die Amiga-Includehles 2.04, Version 37.4. Zusätzlich 
zu den Commodore-Standardincludefiles gibt es Includefiles im Ivo-Directory, die 
die Offset-Definitionen für die Standard-Systemlibraries enthalten. Eine Neuerung: 
exec/types.i enthält jetzt Makros, die automatisch bei z.B. LONG auf eine Wortgrenze 
gehen. 

Die von Commodore original herausgegebenen Includefiles enthielten einige Fehler und 
wurden fehlerbereinigt, die Änderungen finden Sie in der Datei LiesMich. Damit Sie 
beim Assemblieren eine hohe Geschwindigkeit erreichen, wurden in den Dateien in In¬ 
clude die meisten Kommentare entfernt, und sie sind speziell an OMA angepaßt. Da die 
originalen Commodore-2.04-Includehles für die Programmierung wichtige Kommentare 
enthalten, wurde die Version mit Kommentaren gepackt beigelegt. 

Includel.3 enthält die alten Amiga-Includefiles der Workbench 1.3. Das Symbol »TC< 
wurde in exec/tasks.i in »TC_« geändert, um die Namenskollision mit dem PMMU- 
Register zu vermeiden. 

6.7 Das Examples-Directory 

Examples enthält Quelltexte für einige der Programme und Beispiele der Assembler- 
Programmierung und in diesen auch deren Beschreibung. Im Unterdirectory Library ist 
der komplette Quelltext für die >amiga.lib<-kompatible Library »OMA.lib« enthalten. 
»OMA.lib« selber finden Sie im Libraries-Directory. Im Unterdirectory Startup ist der 
Quelltext für die Startup-Objektfiles aus dem Libraries-Directory enthalten. 


6.8 Das Libraries-Directory und OMA.lib 

Dieses Directory enthält die Library OMA.lib sowie zwei Startup-Objektfiles, nämlich 
startup. obj für den kombinierten GLI- bzw. Workbench-Startup und cli.obj nur für das 
CLI. Die Quelltexte zu diesen Dateien befinden sich im Directory Examples/Startup 
bzw. Examples/Library. 

Die OMA.lib ist eine zur »ainiga.lib« kompatible Library. Für alle System-Bibliotheken 
des Amiga sind C-Interfaces vorhanden, die die Parameter rückwärts auf den Stack 
geschoben erwarten. Die IEEE-Trans-Library der Workbench 1.3 wird auch unterstützt. 
Ferner sind Hilfsroutinen vorhanden, deren Beschreibung unten folgt. Beachten Sie, daß 
die Routinennamen für den Assembleraufruf mit einem Unterstrich beginnen müssen. 
Die Quelltexte zur OMA.lib sind vollständig tabulator-komprimiert vorhanden. 

Die Unterstützungsroutinen namens _AddlCRVector, _RemlCRVector, _SetlCR und 
_AblelCR wird es nicht geben, ebenso fehlen alle Routinen der Form faddi. fmuli usw. 
Benutzen Sie dafür von Assembler aus die direkten Aufrufe per »jsr _LVOabc(a,6)< 
oder die C-Interface-Routine »jsr _a,bc«. 
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amiga.libist neben ein paar anderen originalen Commodore-Bibliotheken im Directory 
Libs2.0 enthalten. Die Startup-Programme von Commodore finden sich im Directory 
startups. 


NewList (Zeiger auf Listenstruktur) 

Ermöglicht es, den NEWLIST-Makro von C aus zu nutzen. 

BeginlO (IO-Zeiger) 

Ermöglicht es, den BEGINIO-Makro von C aus zu nutzen. 

Portzeiger = CreatePort (Namenzeiger, Priorität) 

Erzeugt einen Port mit gegebenem Namen und Priorität. Rückgabewert in DO; 
gibt Null zurück, wenn Port nicht erzeugt werden konnte. 

DeletePort (Portzeiger) 

Entfernt, den Port aus dem System. 

IOStdReq-Zeiger = CreateStdIO (ioReplyPort) 

Erzeugt eine Standard-IO-Struktur. »ioReplyPort« zeigt auf den Antwort-Port. 
Rückgabe in DO; gibt Null zurück, wenn etwas schiefging. 

DeleteStdIO (IOStdReq-Zeiger) 

Gibt die erzeugte Struktur wieder frei. 

IORequest-Zeiger = CreateExtIO (ioReplyPort, Requestgröße) 

Erzeugt eine erweitere Standard-IO-Struktur. »Requestgröße« gibt deren Größe 
an und sollte nie kleiner als IOSTD.SIZE sein! Rückgabe in DO; gibt Null zurück, 
wenn etwas schiefging. 

DeleteExtIO (IOExt-Req-Zeiger) 

Gibt die erzeugte Struktur wieder frei. 

Taskzeiger = CreateTask (Namenzeiger, Priorität, AnfangsPC, Stackgröße) 
Erzeuge eine Task. Rückgabe in DO; gibt im Fehlerfall Null zurück. 

DeleteTask (Taskzeiger) 

Entfernt die Task aus dem System. 


IDivS (argl, arg2) 

Teilt argl (32 Bit) durch arg2 (16 Bit) vorzeichenbehaftet. Rückgabe: 32-Bit- 
Ergebnis vorzeichenbehaftet. 

IDivU (argl, arg2) 

Teilt argl (32 Bit) durch arg2 (16 Bit) vorzeichenlos. Rückgabe: 32-Bit.-Ergebnis 
vorzeichenlos. 
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IMulS (argl, arg2) 

Multipliziert argl (16 Bit.) mit arg2 (16 Bit) vorzeichenbehaftet. Rückgabe: 32- 
Bit-Ergebnis vorzeichenbehaftet.. 

IMulU (argl, arg2) 

Multipliziert argl (16 Bit) mit arg2 (16 Bit) vorzeichenlos. Rückgabe: 32-Bit- 
Ergebnis vorzeichenlos. 

Die folgenden Routinen gibt es nur für Assembler und ohne den Unterstrich. Sie arbeiten 
mit reiner 32-Bit-Arithmetik. 

Imult ulmult 

DO = DO * Dl vorzeichenlos oder vorzeichenbehaftet. 

ldivt 

DO = DO / Dl vorzeichenbehaftet. 

lmodt 

DO = DO mod Dl vorzeichenbehaftet. 

uldivt 

DO = DO / Dl vorzeichenlos. Zusätzlich: Modulo in Dl. 

ulmodt 

DO = DO mod Dl vorzeichenlos. Zusätzlich: Quotient, in Dl. 

FFP = afp (Stringzeiger) 

Wandelt, einen ASCII-String in eine FFP-Fließkommazahl um. Rückgabe in DO. 

FFPAFP 

Assemblerversion von _afp ohne den Unterstrich im Namen. Eingabe: AO zeigt 
auf den umzuwandelnden ASCII-String. Ausgabe: D7 und DO enthalten die 11 P- 
Fließkommazahl und AO zeigt direkt hinter den gelesenen ASCII-String. Falls 
ein Fehler auftrat, ist das Carry-Flag gesetzt, und AO zeigt auf die Fehlerstelle. 

Exponent = fpa (FFP-Zahl, Stringzeiger) 

Wandelt eine FFP-Fließkommazahl in einen ASCII-String um. 

FFPFPA 

Assemblerversion von Jpa. Eingabe: DO enthält die FFPT ließkommazahl und 
AO zeigt auf den Zielstring. Ausgabe: DO enthält, den Exponenten als vorzci- 
chenbehafteten 32-Bit-Integer. 


FastRand (Zahl) 

Erzeugt schnell einen Pseudo-Zufallszahl unter Benutzung der »Zahl«. Rück¬ 
gabe: Die Zufallszahl. Sollte für das nächste Mal gespeichert werden. 

RangeRand (Bereich) 
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Erzeugt eine Zufallszahl im Bereich 1 bis »Bereich«. »Bereich« muß im Bereich 
1 bis 65535 liegen. Rückgabe: Die Zufallszahl. 

AddTOF (Interruptstruktur-Zeiger, C-Eoutinen-Zeiger, Datenfeldzeiger) 

Hängt eine C-Routine in die Vertical-Blank-Interrupt-Serverkette. Der C- 
Routine wird der Zeiger auf das Datenfeld übergeben. Rückgabe: Keine. Siehe 
auch den Quelltext. 

RemTOF (Interruptstruktur-Zeiger) 

Entfernt die C-Routine wieder aus der Serverkette. Rückgabe: Keine. 

waitbeam (Positionszeile) 

Wartet, bis der Videostrahl über die Positionszeile gelaufen ist. Rückgabe: Die 
aktuelle Videostrahl-Position. 


fprintf (File, Formatstringzeiger {Argliste)} 

Formatiert den Formatstring mit der Argumentliste und schreibt den Zielstring 
in ein File. Rückgabe: 0. Im Fehlerfall -1. 

printf (Formatstringzeiger {Argliste)} 

Formatiert den Formatstring mit der Argumentliste und schreibt den Zielstring 
nach »stdout«. Rückgabe: 0. Im Fehlerfall -1. 


puts (Stringzeiger) 

Schreibt einen String auf »stdout«. Das Stringende 0 wird durch ein Linefeed 
ersetzt. Rückgabe: Linefeed. Im Fehlerfall -1. 

fputs (Stringzeiger, File) 

Schreibt einen String in ein File. Das Stringende 0 wird nicht geschrieben. Rück¬ 
gabe: Das letzte ausgegebene Zeichen. Im Fehlerfall -1. 

getchar () 

Lies genau ein Zeichen von »stdiri«. Rückgabe: Das gelesene Zeichen. Im Feh¬ 
lerfall oder bei Fileende -1. 

putchar (Zeichen) 

Gib ein Zeichen auf »stdout« aus. Rückgabe: Das ausgegebene Zeichen. Im 
Fehlerfall -1. 

fgetc (File) 

Lies genau ein Zeichen aus einem File. Rückgabe: Das gelesene Zeichen. Im 
Fehlerfall oder bei Fileende -1. 

fputc (Zeichen, File) 

Gib ein Zeichen auf ein File aus. Rückgabe: Das ausgegebene Zeichen. Im Feh¬ 
lerfall -1. 

fclose (File) 

Schließe das File. 


sprintf (Stringzeiger, Formatstringzeiger {Argliste)} 

Formatiert den Formatstring mit der Argumentliste und schreibt den Zielstring 
in (Stringzeiger). Rückgabe: Der Zeiger auf den Zielstring. 
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Kapitel 7 

Objektorientierte 
P r ogr ammier ung 

7.1 Einführung in OOP 

Dieser Abschnitt ist eine kurze Einführung in die allgemeinen Begriffe der objektori¬ 
entierten Programmierung. Es ist ratsam, zu dem Thema bereits Vorkenntnisse zu 
besitzen oder Sekundärliteratur zu lesen. 


7.1.1 Motivationsbeispiel 

Wormale Programmentwicklung sollte mit dem Modulkonzept arbeiten, bei dem ein 
Aufgabengebiet einem Modul zugeteilt wird. Z.B. wird für ein Anwendungsprogramm 
ein Fenstermodul entworfen, das sich um die Verwaltung eines Fensters kümmert. 
Zu seinen Aufgaben gehört das Öffnen eines Fensters, das Schließen, das Ändern der 
IDCMP-Flags sowie das Anhängen und Entfernen eines Menüs. Damit mehrere Fen¬ 
ster verwaltet werden können, hat das Modul noch eine Routine zum Erzeugen einer 
Fensterverwaltungs-Struktur und zum Löschen derselben. Das Modul wird implemen¬ 
tiert und funktioniert zufriedenstellend. Nun bemerkt man, daß das Programm neben 
einfachen Fenstern mit Textdarstellung noch solche benötigt, die irgendwelche Gadgets 
enthalten. Natürlich kann das Fenstermodul entsprechend erweitert werden, aber ab 
einer bestimmten Anzahl verschiedener Fenstertypen hat man im Modul eine Menge 
Ablragen, welcher Typ denn gerade vorliegt und welche Aktionen daraufhin ausgeführt 
bzw. weggelassen werden müssen. Je mehr neue Typen hinzugefügt werden, desto un¬ 
durchsichtiger wird die Situation, und die Fehlerwahrscheinlichkeit steigt zusammen 
mit der Verzweiflung. 

Die objektorientierte Programmierung ( OOP) ist hier in der Lage, die Behandlung der 
verschiedenen Fenstertypen auseinanderzuziehen und voneinander abzugrenzen. 
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7.1.2 OOP-Grundbegriffe 

OOP faßt die Welt als Ansammlung von Objekten auf. Ein Objekt ist dabei das Modell 
eines realen (oder nur im Rechner), existierenden Gegenstandes mit seinen spezifischen 
und allgemeinen Eigenschaften. Ein Objekt wird im Rechner als Datencontainer zusam¬ 
men mit Routinen, die das Objektverhalten bestimmen, repräsentiert, d.h., ein Objekt 
besteht aus seinen Daten und den zugehörigen Routinen. Ein Mensch hat z.B. als Da¬ 
ten eine Altersangabe, ein Geschlecht und einen Namen, und als Routinen das Laufen, 
Sitzen, Altern usw. Da es meist viele Objekte mit gleichem Datenaufbau und gleichen 
Routinen gibt, werden alle Objekte mit den gleichen Eigenschaften derselben Klasse 
zugeteilt. Z.B. haben alle Objekte der Klasse »Mensch«: das Laufen, Sitzen und Altern 
gemeinsam, und es wäre Speicherverschwendung, für jeden einzelnen Menschen diese 
Routinen zu implementieren. Neben den Routinen, die das Verhalten der Objekte reali¬ 
sieren, enthält die Klasse noch die Routinen zum Erzeugen und Löschen von Objekten. 
Alle Routinen werden als Methöden bezeichnet (warum, wird unten klar). 

Die Klasse ist somit nur eine Schablone für Objekte; sie bestimmt die Struktur sowie 
die Methoden der Objekte. Während der Laufzeit eines OO-Prograrnmes müssen erst 
noch Objekte dieser Klassen erzeugt werden. Ein erzeugtes Objekt wird als Objekt- 
Instanz bezeichnet. Es besteht entsprechend der Schablone aus den Daten, die jedes 
Objekt nur für sich hat, z.B. das Alter eines Menschen, welches von Menschobjekt zu 
Menschobjekt meist verschieden ist. Diese Daten heißen Instanzvariablen. Zusätzlich 
enthält es einen Verweis auf die Klasse, der es angehört. Die Klasse wird durch den 
Klassen Container repräsentiert, der aus ein paar Daten wie z.B. der Instanzgröße und 
dem Code der Methoden besteht. 

Eine fertige Klasse kann erweitert werden, ohne daß sie geändert zu werden braucht. 
Dabei entsteht eine neue Klasse, die weitgehend das Verhalten der alten Klasse be¬ 
sitzt, aber deren Funktionalität ändern kann und neue Funktionalität hinzufügen darf. 
Diesen Vorgang bezeichnet man als Erben. OMA unterstützt nur das einfache Erben, 
bei dem genau eine Klasse als Vererber erlaubt ist. Die Erbrelation ergibt eine Ver¬ 
erbungshierarchie, in der es vererbende Klassen, Oberklassen oder Superklassen, gibt, 
und erbende Unterklassen bzw. Subklassen. Sollte Klasse C von Klasse B erben, die 
wiederum von Klasse A erbt, so ist auch A eine Oberklasse von C, da C über B Eigen¬ 
schaften von A erbt. B hat aber von allen Oberklassen von C eine Sonderstellung, da 
es die direkte Oberklasse von C ist. A ist nur eine indirekte Oberklasse von C, aber Bs 
direkte Oberklasse. 

Im obigen Beispiel gäbe es eine Klasse Fenster, von der sowohl die Klasse Textfenster 
als auch die Klasse Gadgetf enster erben würden. In Fenster käme all die Funktio¬ 
nalität, die Textfenster und Gadgetf enster vollkommen gemeinsam haben. In den 
Unterklassen findet sich dann diejenige, die für die Klasse spezifisch ist, z.B. die Cad- 
getverwaltung ausschließlich in Gadgetf enster, da unsere Textfenster keine Gadgets 
besitzen sollen. Da ein Objekt der Klasse Fenster keinen Sinn macht (sie hat nicht 
genügend Funktionalität), sondern erst ein Objekt einer von ihr erbenden Klasse, faßt 
Fenster nur gemeinsame Konzepte zusammen. Fenster kann auch Methoden deklarie¬ 
ren, die erst in den Unterklassen existieren. Eine solche Klasse wie Fenster heißt eine 
abstrakte Klasse. Sie legt nur fest, welches Verhalten in den Unterklassen existieren 
muß, und wird selber niemals Objekte erzeugen. 
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Durch die Erbhierarchie mit Klassen werden zwei Relationen zwischen Objekten und 
Klassen erzeugt. Die eine Relation ist. die »ist-ein«-Relat.ion, z.B. »ist-ein« Objekt 
der Klasse Gadgetf enster ein Gadgetfenster. Die zweite Relation ist die schwächere 
»ist-eine-Art«-Relation, z.B. ist dieses Objekt gleichzeitig nur eine Art Fenster. 

7.1.3 Methoden 

Um mit einem Objekt etwas anfangen zu können, muß man es manipulieren können. 
Da Objekte Daten abkapseln sollen und daher kein Zugriff auf Instanzvariablen von 
außerhalb der Klassen erfolgen darf, existieren wie oben gesagt Routinen, über die 
sämtliche Interaktion mit dem Objekt stattfindet. Diese Methoden sind prinzipiell genau 
so wie Unterroutinen, nur wird die Entscheidung, wohin der Sprung erfolgt, erst zur 
Laufzeit getroffen. Wenn z.B. Klasse Hund die Methode Hund_Laufen besitzt und die 
Klasse Kuvasz (eine Hunderasse) von Hund erbt und wegen der manchmal eigenartigen 
Gangweise eines Kuvasz die Methode HundMaufen ebenfalls implementiert, nur in leicht 
anderer Weise, so spricht, man vom Uberschreiben der Methode (engl, ovenvrite). Beim 
Aufruf der Methode Hund_Lauf en hängt es von der Klassenzugehörigkeit des Objektes 
ab, welcher Code angesprungen wird. Diese Eigenschaft, heißt Polymorphismus. 

Innerhalb der überschreibenden Methode muß es eine Möglichkeit, geben, auch den Code 
der gleichnamigen Routine in der Oberklasse zu erreichen. Der Aufruf der Methode sel¬ 
ber würde nämlich nur zum erneuten Aufruf der Methode derselben Klassenebene und 
damit wahrscheinlich zu einer Endlosschleife führen. Dies geschieht unter Verwendung 
des sogenannten 5uper-Aufrufes. 

In jedem Fall muß der Methodencode Zugriff auf das Objekt selber haben. Dazu wird 
implizit jeder Methode der Zeiger auf das Objekt, mitgegeben. Dieser Zeiger wird mei¬ 
stens mit Seif bezeichnet. 

Damit die Entscheidung des Sprungziels effizient, getroffen werden kann, wird in der 
Regel der Methodenname bei der Übersetzung des Quelltextes in einen Zahlencode 
überführt, der Methoden-ID. 

Anhand der Methoden wird auch deutlich, welche Vorteile OOP bietet. Wenn die Unter¬ 
klasse für eine bestimmte Methode keine andere Funktionalität benötigt als die Ober¬ 
klasse, kann sie die Methode einfach miterben, indem sie sie nicht überschreibt. Der 
Code für Methode ist damit, nur einmal, nämlich in der Oberklasse, vorhanden, und 
die neue Klasse braucht, sich nur um neu eingeführte und überschriebene Methoden zu 
kümmern. Ihr Aufgabengebiet, ist. somit klar eingegrenzt, und übersichtlich. 


7.2 OOP-Struktur bei OMA 

OMA unterstützt, auch das objektorientierte Programmieren. Damit die Nutzung von 
OOP unter OMA recht bequem gestaltet ist,, gibt es das Includehle ooma.i, in dem Ma¬ 
kros und Strukturen zur einfachen Deklaration von Klassen, Methoden und Objekten 
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enthalten sind. Die entsprechenden Routinen müssen mit dem Modul ooma.obj hinzu¬ 
gelinkt werden. Bevor irgendeine andere Aktion der Klassen- und Objektverwaltung 
angefordert werden darf, muß InitObjectModule aufgerufen worden sein. 

7.2.1 Klassenhierarchie und ClassObject 

An der Spitze der Klassenhierarchie von OMA steht die abstrakte Klasse ClassObject, 
die direkte oder indirekte Oberklasse von allen anderen Klassen sein muß. Die Basis¬ 
klasse ClassObject definiert den Verweis auf den Klassencontainer sowie die Methoden 
Object_Initialize, Object.Cleanup und Object_Delete. Object_Initialize muß in 
den Unterklassen realisiert werden und sollte dort das Objekt in einen definierten Zu¬ 
stand bringen. Object_Cleanup sollte kurz vor dem Löschen des Objektes aufgerufen 
werden, damit z.B. in Instanzvariablen vermerkter, belegter Speicher wieder freigegeben 
oder eine offene Datei geschlossen werden kann. Unterklassen werden Object-Cleanup 
überschreiben, um die Aufräumarbeiten ihrer Klassenebene, von denen ClassObject 
ja nichts wissen kann, durchzuführen und anschließend Object_Cleanup der Oberklasse 
aufzurufen. Object_Delete gibt nur den durch die Objektstruktur belegten Speicher 
frei und darf bei Objekten, die nicht über CreateObject oder CreateObjectNoClear 
erzeugt wurden, keinesfalls aufgerufen werden. Dies trifft z.B. auf Objekte zu, die auf 
dem Stack reserviert wurden. 

7.2.2 Erzeugen eines Objektes 

Objekt-Speicherplatz 

Ein Objekt kann prinzipiell auf zwei Arten an Speicherplatz kommen. Die erste 
Art ist der Aufruf CreateObject, der den Speicher per Systemfunktion AllocMem() 
belegt und alle Instanz variablen des Objekts löscht. Zu dieser Art gehört auch 
CreateObjectNoClear, das wie CreateObject arbeitet, aber die Instanzvariablen nicht 
löscht. Der zweite Weg besteht darin, den Speicherplatz selber zu reservieren. Die Größe 
eines Objektes ist ja im allgemeinen durch die Definition des Objektes bekannt bzw. 
sollte über Includefiles leicht erreichbar sein. Damit die Klasse des Objekts bekannt ist, 
muß aber als erstes der Makro INITOBJECT aufgerufen werden. Danach ist das Objekt 
im selben Status wie nach der Erzeugung durch CreateObjectNoClear, d.h., eventu¬ 
ell wird es noch nötig sein, die Instanzvariablen zu löschen. Geeigneter Speicherplatz 
könnte sich u.a. auf dem Stack befinden. 

Objekt-Initialisierung 

Das Anlegen des Objektes reicht in der Regel nicht aus. Die meisten Objekte brau 
chen einen Anfangszustand für die Instanz variablen. Deswegen existiert die Methode 
Object_Initialize,die in Unterklassen überschrieben werden sollte, damit die dortigen 
Initialisierungen wie Belegen von zusätzlichem Speicher durchgeführt werden können. 
Beispielsweise wird die Methode für die Klasse ClassWindow dann Window_Initialize 
heißen (siehe auch 7.5 für Namensregelung). 
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Nach der Initialisierung ist das Objekt fertig zum Gebrauch entsprechend der vorgese¬ 
henen Methoden. 

7.2.3 Methodenaufrufe 

Ein normaler Methodenaufruf wird mit Hilfe der Direktive METHOD vorgenommen. 
Das erste Argument der Direktive ist der Zeiger auf das Objekt, das zweite die 
Methoden-TD, z.B. Window_Initialize. Der Objektzeiger darf dabei jede beliebige 
Adressierungsart sein. Die Argumente, die die Methode bekommen soll, werden wie 
bei normalen Unterroutinenaufrufen entweder über den Stack oder in Registern über¬ 
geben. Für die durch ClassObject vordefinierten Methoden sollte unbedingt die Regi¬ 
sterbelegung eingehalten werden, damit keine Fehler durch Unachtsamkeit entstehen. 
Ein Beispiel für Methodenaufrufe: 

; A5 zeige auf Objekt "Benji" der Klasse "Hund" 

METHOD a5,Hund_Belle 
METHOD tom,Katze_AufDenBaum 
METHOD #jerry,Maus_Lachen 

tom ds.l 1 ; Zeiger auf Objekt der Klasse "Katze" 

jerry ds.b Maus_SIZEOF 

Nach der METHOD-Direktive ist das Register A6 verändert /Innerhalb der aufgerufenen 
Methode zeigt das Register A5 auf das Objekt, auf das die Methode angewandt wird, 
und nimmt somit die Stellung von Seif ein. Dieses Vorbesetzen von A5 erledigt die 
METHOD-Direktive.. 

7.2.4 Vernichtung von Objekten 

Nach Gebrauch muß ein Objekt früher oder später vernichtet werden. Entsprechend 
der Erzeugung des Objektes muß zuerst die in Unterklassen überschriebene Me¬ 
thode Object_Cleanup aufgerufen werden (z.B. Window.Cleanup für Objekte der Klasse 
Window). Diese wird die Initialisierung rückgängig machen, die in der Initialize-Methode 
vorgenommen wurde. Die weitere Vorgehensweise hängt von der Speicherplatzart ab, die 
das Objekt belegt. Falls es per CreateObject oder CreateObjectNoClear belegt wurde, 
muß zum Freigeben noch seine Delete-Methode aufgerufen werden (z.B. Window_Delete. 
Für selbst reservierte Objekte, die den INITOBJECT-Aufruf erfuhren, ist von Seiten des 
Objektsystems her nichts mehr zu tun. Nach der Vernichtung dürfen keinesfalls noch 
Methoden an das Objekt geschickt werden. 

7.3 Implementierung von Klassen 

Um eigene Klassen definieren zu können, stellt OMA spezielle Makros in dem Includefile 
ooma.i zur Verfügung, ooma.i inkludiert automatisch das Amiga-Includefile exec/types.i, 
damit Strukturdeklarationen wie im folgenden einfach möglich sind. 
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7.3.1 Schritt 1: Objektstruktur deklarieren 

Die Objektstruktur muß zuerst deklariert werden, da die Größe eines Objektes für die 
Klassendeklaration bekannt sein muß. In die Objektstruktur geht auch ein, von welcher 
Klasse geerbt wird. Dies geschieht einfach, indem die Instanzvariablen der Oberklasse 
am Anfang der Objektstruktur stehen und die neuen dahinter kommen, z.B. Erben von 
ClassObject: 


7.3.3 Schritt 3: Klassencontainer anlegen 

Die beiden vorigen Schritte sollten in einem Includefile vorhanden sein, damit Benutzer 
der Klasse die Methodennamen einfach inkludieren können. In dem Modul, das die 
Klasse und die Methoden schließlich implementiert, muß Platz für den Klassencontainer 
angelegt werden. Mit dem Makro DEFINECLASS und den Argumenten Klassenname und 
Klassencontainergröße läßt sich dies einfach bewerkstelligen: 


STRUCTURE Rechteck,object_SIZEOF 
UWORD rechteck_Höhe 
UWORD rechteck_Breite 

LABEL rechteck_SIZEOF ; Größe eines Rechtecks 

object_SIZEOF ist dabei die Anzahl von Bytes, die ein Objekt der Klasse ClassObject 
benötigt, und stammt aus dem Includefile ooma.i. Dadurch, daß die Instanz variablen der 
Oberklasse in allen Unterklassen denselben Abstand vom Beginn des Objektes haben, 
wird Vererbung überhaupt erst möglich. 


7.3.2 Schritt 2: Methoden deklarieren 


Nach der Objektstruktur werden die Methoden deklariert. Obwohl es möglich ist, die 
Methoden der Oberklasse, die nicht überschrieben werden sollen, mit dem Präfix der 
Oberklasse anzusprechen, schafft es mehr Übersicht, diese Methoden mit dem Präfix 
der neuen Klasse zu deklarieren. Dann braucht man sich nämlich nicht mehr beim 
Methodenaufruf darum zu kümmern, zu welcher Oberklasse die Methode gehört (dies ist 
für den Aufruf ja unerheblich). Diese Neudeklaration geschieht mittels des SAMEMETHQD- 
Makros: 

SAMEMETHOD Rechteck.Initialize,Object_Initialize 

SAMEMETHOD Rechteck_Cleanup,Object_Cleanup 

SAMEMETHOD Rechteck_Delete,Object_Delete 

Die neuen Methoden-IDs, die erst in der neuen Klasse deklariert werden, müssen 
direkt an die Methoden-IDs der Oberklasse anknüpfen. Dazu gibt es den Makro 
BEGINMETHOD, der als Argument die Klassencontainergröße der Oberklasse braucht. Die 
neuen Methoden-IDs werden dann mit dem Makro DEFINEMETHOD deklariert . Am Ende 
muß die Klassencontainergröße unserer neuen Klasse ermittelt werden, damit andere 
Klassen später von uns erben können. Dies geschieht per ENDMETHOD-Makro und wird 
später von BEGINMETHOD so ausgenutzt, wie wir es gerade selber gemacht haben. Bei¬ 
spiel: 


BEGINMETHOD 

DEFINEMETHOD 

DEFINEMETHOD 

DEFINEMETHOD 

DEFINEMETHOD 

ENDMETHOD 


Object_ClassSize 
Rechteck_SetzeHöhe 
Rechteck_SetzeBreite 
Rechteck_BerechneUmfang 
Rechteck_BerechneFläche 
Rechteck_ClassSize 


CNOP 0,4 

DEFINECLASS ClassRechteck,Rechteck.GlassSize 

Wegen makrointerner Verwaltung ist es wichtig, daß die Klassendeklaration im Quell¬ 
text vor den Methoden geschrieben wird. Der Platz für den Klassencontainer kann 
beliebig in einem Hunk liegen, sollte allerdings vorzugsweise in einen BSS-Hunk und 
auf langwort.-ausgerichtete Adresse kommen. Daher das obige CNOP. Der Name der 
Klasse, hier ClassRechteck, sollte zum Erzeugen von Objekten mit CreateObject per 
XDEF-Direktive exportiert werden. 

Sollten Sie noch eigene Daten mit einer Klasse assoziieren können, so verwenden Sie 
dafür das reservierte Feld APTR class_pUserData im Klassencontainer, z.B. move.l 
aO, ClassRechteck+class-pUserData. 

7.3.4 Schritt 4: Methoden implementieren 
Einfache Implementierung 

Methoden werden prinzipiell genau so wie normale Unterroutinen geschrieben. Dies gilt 
auch für die Parameterübergabe, die in Registern (außer A6, s.o.) oder aul dem Stack 
stattfinden kann. Der Unterschied besteht darin, daß der Einsprungpunkt der Methode 
mit dem Makro METH0DB0DY festgelegt wird, da die die Namen der in Schritt 2 dekla¬ 
rierten Methoden-IDs ja schon vergeben sind. Da,s Label, das einer Methode zugewiesen 
wird, ist die Methoden-ID mit einem »m_«-Präfix, z.B. mJtechteck_SetzeHöhe. Inner¬ 
halb einer Methode ist das Register A5 der Self-Zeiger auf das Objekt und ermöglicht 
schnellen Zugriff auf die Instanzvariablen. Beispiel: 

; Setze die Höhe eines Rechtecks. 

; Eingabe: A5: Seif. 

; DO: neue Höhe. 

; Ausgabe: Keine. 

METH0DB0DY Rechteck.SetzeHöhe 

move dO,rechteck_Höhe(a5) 
rts 


Um in den Methoden bequemer programmieren zu können, sollten Sie die Möglichkeiten 
der Makros im Includefile macros.i ausnutzen. Dort finden Sie das automatische Retten 
von benutzten Registern und das Anlegen von lokalen Y ariablen auf dem Stack. 
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Natürlich kann von einer Methode aus eine andere Methode u.U. eines anderes Ob¬ 
jekts aufgerufen werden. Ein Problem taucht aber auf, wenn Sie in einer überschriebe- 
nen Methode ihrer Klasse die Methode des gleichen Namens der Oberklasse aufrufen 
wollen. Das normale Verwenden von METHOD würde dabei nur zum erneuten Aufruf 
der Methode derselben Klassenebene und damit wahrscheinlich zu einer Endlosschleife 
führen. Daher gibt es die Direktive SMETHOD, die den gewünschten Effekt bewirkt. 
Aus Komfortgründen sollten Sie aber den Makro SUPER aus ooma.i verwenden, der die 
gleichen Argumente wie METHOD hat. 

Aufrufkett eil 

Überschriebene Methoden, die mit den Methoden gleichen Namens in der Oberklasse 
interagieren, bilden über die Klassenebenen hinweg Aufrufketten. Ein gutes Beispiel 
hierfür sind Methoden, die Object_Initialize und Object_Cleanupoder eine ihrer Fol¬ 
gemethoden überschreiben. Hier muß besonders auf die Reihenfolge der SUPER-Aufrufe 
geachtet werden, damit das System im konsistenten Zustand verbleibt. Beim initialisie¬ 
ren sollten zuerst immer die Instanzvariablen der Oberklassen initialisiert werden, erst 
dann die eigenen: 

METHODBODY Window_Initialize 

PROC dl/a0-al/a6 

; Erst Oberklasse initialisieren. 

SUPER a5,Window_Initialize 

; Belege privat genutzten Speicher. 

clr window_width(a5) 

clr window_height(a5) 

moveq #16,d0 

moveq #0,dl 

CALL AllocMem,_SysBase 

move.l dO,window_myMemory(a5) 

ENDPROC 

Aus Gründen der Übersichtlichkeit wird hier keine Prüfung durchgeführt, ob die Initia¬ 
lisierung der Oberklasse gelang oder ob der Speicher auch belegt werden konnte. Beim 
Aufräumen kurz vor dem Löschen des Objektes sollten zuerst die eigenen Arbeiten 
erledigt werden, danach die der Oberklassen: 

METHODBODY Window_Cleanup 

PROC dO-dl/aO-al/a6 

; Gib privaten Speicher wieder frei, 
move.l window_myMemory(a5),d0 

beq.s .noraem ; es gab keinen Speicher 

move.l dO,al 

moveq #16,dO 

CALL FreeMem,_SysBase 
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; Jetzt Oberklasse aufräumen. 

.nomem SUPER a5,Window_Cleanup 
ENDPROC 

7.3.5 Schritt 5: Klassen registrieren 

Damit, das Objektsystem überhaupt Kenntnis von der Klasse hat, muß die Klasse vor 
jeglicher Verwendung bei ihm angemeldet werden. Dafür gibt es im Objektmodul die 
Routine RegisterClass, die von einer Initialisierungsroutine in Ihrem Klassenmodul 
aus aufgerufen werden muß. Ein Argument dieser Routine ist ein Zeiger auf ein Initiali¬ 
sierungsfeld. Dieses Feld legt fest, welche Methoden in der Klasse neu vorhanden sind. 
Es wird per Makro OVERWRITE deklariert und muß immer mit dem ENDOVERWRITE-Makro 
abgeschlossen werden. Wird eine neue Methode der Klasse hier vergessen, dann ist ent¬ 
weder der Methodenzeiger der Oberklasse oder ein Nullzeiger in der Methodentabelle 
eingetragen. Dies führt dann beim Methodenaufruf zu einem Fehler. Beispiel: 

MeldeRechteckAn 

PROC d0-dl/a0-a2 

lea ClassRechteck.aO 
lea ClassObject,al 

lea ,array,a2 

. moveq #rechteck_SIZEOF,dO 
moveq #Rechteck_ClassSize,dl 
jsr RegisterClass 

ENDPROC 

.array OVERWRITE Rechteck_Initialize 

OVERWRITE Rechteck_SetzeHöhe 

OVERWRITE Rechteck_SetzeBreite 

OVERWRITE Rechteck_BerechneUmfang 

OVERWRITE Rechteck_BerechneFläche 

ENDOVERWRITE ; Abschluß 

Wenn die Initialisierungsroutinen aller Klassen aufgerufen worden sind und damit alle 
Klassen angemeldet wurden, muß noch die Routine InitializeClasses im Objektmo¬ 
dul in Aktion treten. Sie initialisiert alle Klassencontainer, trägt, die Methodentabellen 
ein und bringt somit das Objektsystem in den Anfangszustand. Erst ab diesem Zeit¬ 
punkt dürfen Objekte erzeugt und verwendet werden. 

7.4 OOP-Beispiel 

Sie finden auf der Originaldiskette ein Beispiel für OOP mit dem OMA mit ausführli¬ 
chen Kommentaren. Das Beispiel zeigt die Deklaration zweier Klassen ClassRechteck 
und ClassQuadrat, wobei Quadrate von Rechtecken erben, die wiederum ClassObject 


Klassenzeiger 

Oberklasse 

Initialisierungsfeld 

Objektgröße 

Klässengröße 





186 _ KAPITEL 7. OBJEKTORIENTIERTE PROGRAMMIERUNG 

als Oberklasse besitzen, ln dem Beispiel kommen alle wichtigen Techniken vor, die 
Sie für OOP mit dem OMA brauchen, u.a. auch das Belegen von Objekten per 
CreateObject und auf dem Stack. 


7.5 Benennungskonventionen 

Damit einigermaßen Klarheit über Klassen, Methoden etc. herrscht, gibt es bei OMA 
eine Konvention für die Benennung. 

• Alle Klassen beginnen mit dem Präfix »Class«, also ClassObject und 
ClassWindow. 

• Methodennamen beginnen mit dem Klassennamen ohne »Class«-Präfix, 
aber mit einem folgenden Unterstrich, beispielsweise Object_Initialize, 
Object.Cleanup und Window_Close. 

• Instanzvariablen sollten wie Methodennamen beginnen, nur sollte der Klassen¬ 
name darin klein geschrieben werden, z.B. window_width. 

• Damit die Größe eines Objektes zum Erzeugen der Klasse bekannt ist, sollte am 
Ende der Objektdefinition immer ein Label mit dem Suffix »_SIZEOF« deklariert 
werden, z.B. window_SIZEOF. 

• Entsprechend wird für die Methodendeklaration die Größe des Klassencontainers 
benötigt, welche die Form des Klassennamens mit dem Suffix ».GlassSize« haben 
sollte, z.B. Window_ClassSize. 

Diese Konvention sollte von allen befolgt werden. 
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